# HTTP Driver

## POST /:object/db/bulk

Performs a bulk operation, consisting of 1 or more driver operations. Bulk operations may be nested. For more information and examples, see [Bulk Operation](/cortex-api/scripting/http-driver.md) in the scripting section.

{% tabs %}
{% tab title="mdctl-cli" %}

```bash
$> mdctl api POST /accounts/db/bulk --file ./bulk-def.json --env=dev.example
```

{% endtab %}

{% tab title="Javascript" %}

```
$.ajax({
  url: 'https://api.dev.medable.com/example/v2/accounts/bulk',
  method: 'POST',
  dataType : 'json',
  xhrFields: {
    withCredentials: true
  },
  headers: {
    'Medable-Client-Key': 'GsAqlhnIMzrDeD8V2MBQWq'
  },
  data: [{       
    operation: 'updateOne',
    match: {
      email: 'me@example.com'
    },
    update: {
      $set: {
        c_field: true
      } 
    },
    output: false,
    halt: false
  }, {
    operation: 'cursor',
    where: {
      email: 'me@example.com'
    }         
  }]
}).done(function(data) {
  // ...
});
```

{% endtab %}

{% tab title="Response" %}

```javascript
{
  "data": [
    {
      "_id": "5d44e9d78db1c88b69440f33",
      "data": {
        "_id": "5c7fe99ee8355a01008ff899",
        "object": "account"
      },
      "object": "operationResult",
      "path": "cursor[1][0]",
      "timestamp": 1564797399479
    }
  ],
  "hasMore": false,
  "object": "list"
}
```

{% endtab %}
{% endtabs %}

*Path Params*

* `object` { String } The object name.

*Body Params*

* `ops` { Object\[] } An array of bulk operations.  
  * `operation` { String } The operation name. Can be any one of the driver operations (bulk, readOne, cursor, etc.).
  * `object` { String = *undefined* } Sets a new object target for the operation.
  * `name` { String = *undefined* } Wrapped responses will be renamed to this from the operation name.
  * `halt` {Boolean = *true* } If false, an error will not halt the current bulk operation; Errors will instead be pushed to the output stream.
  * `output` {Boolean = *true* } If false, results are not pushed to the output stream.
  * `wrap` { Boolean = *true* } If false, the `operationResult` wrapper is removed from output documents.  
  * `*` { \* } Other individual operation options should be added to the operation object (ie. `match`, `where`, `pipeline`, `limit`, etc.)

*Header Params*

* `Accept` { String = *application-json* } The client can request `application/x-ndjson` to stream newline-delimited JSON documents.

*Response*

* { List } A list result.
  * `data` { OperationResult\[] } An array of wrapped results.
    * `_id` { ObjectID } The operation result identifier.
    * `data` { \* } The wrapped operation result.
    * `object` { String } The object name, `operationResult`.
    * `path` { String } The operation path in the form `operationName[operationIndex][cursorPosition]`.
    * `timestamp` { Number } The timestamp the operation result ws created, in milliseconds. 
  * `hasMore` { Boolean } `true` when more document exists past the cursor. 
  * `object` { String } `"list"`.  

## POST /:object/db/count

Count object instances.

*Path Params*

* `object` { String } The object name.

*Body Params*

* `accessLevel` { String|Number } If set, limits the count to those documents where the caller has at least `accessLevel`.
* `limit` { Number } If set, limits the maximum count.
* `locale` { String } Set the locale for the operation. This affect localized string matches.
* `maxTimeMS` { Number = 10000 } The maximum number of milliseconds the query is allowed to process before an initial cursor is opened.
* `skip` { Number } Skips `skip` documents.
* `where` { Object } A query match filter.

*Response*

* { Result } A result object.
  * `data` { Number } A document count.   
  * `object` { String } `result`. 

## POST /:object/db/cursor

Stream a query or aggregation cursor.

*Path Params*

* `object` { String } The object name.

*Header Params*

* `Accept` { String = *application-json* } The client can request `application/x-ndjson` to stream newline-delimited JSON documents.

*Body Params*

* `accessLevel` { Number }
* `expand` { String\[] }
* `group` { Object }
* `include` { String\[] }
* `limit` { Number }
* `locale` { String }
* `map` { String }
* `maxTimeMS` { Number = 10000 }           
* `paths` { String\[] }
* `passive` { Boolean = false }
* `pipeline` { Object\[] }
* `prefix` { String } A path to use when retrieving a cursor to a List within a readThrough path. 
* `skip` { Number }
* `sort` { Object }
* `where` { Object } 

*Response*

* { List } A list result.
  * `data` { \*\[] } Array of results.
  * `hasMore` { Boolean } `true` when more document exists past the cursor. 
  * `object` { String } `list`. 

##


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.medable.com/cortex-api/scripting/http-driver.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.