Insert Many

Inserts many documents

Use bulk insert when you want to insert many records into the database with one API call. This can be useful when you import data from any other sources.

[InsertMany] - Inserts many documents

Use bulk insert when you want to insert many records into database with one API call. This can be useful when you do import data from any other sources. https://docs.codemash.io/api/database/collections/insert-many

post

/{version}/db/{CollectionName}/bulk

Authorizations

Path parameters

CollectionNameanyrequired

Collection name - unique, lowercased, collection name without whitespace. E.g., if your collection title you have entered in the CodeMash dashboard is "Business Trips" then collection name would be "business-trips".

versionanyrequired

The CodeMash API version used to fetch data from the API. If not specified, the last version will be used. E.g.: v2

Header parameters

Acceptanyrequired

Accept Header

X-CM-Clusterany

API key of your cluster. Can be passed in a header as X-CM-Cluster.

X-CM-ProjectIdanyrequired

ID of your project. Can be passed in a header as X-CM-ProjectId.

CultureCodeany

Specify culture code when your response from the API should be localised. E.g.: en

Body

application/jsonapplication/x-www-form-urlencoded

any

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --request POST \
  --url 'https://api.codemash.io//{version}/db/{CollectionName}/bulk' \
  --header 'Authorization: YOUR_API_KEY' \
  --header 'Content-Type: application/json'

200

200

{
  "response_status": {
    "error_code": "text",
    "message": "text",
    "stack_trace": "text",
    "meta": {
      "ANY_ADDITIONAL_PROPERTY": "text"
    },
    "errors": [
      {
        "error_code": "text",
        "field_name": "text",
        "message": "text",
        "meta": {
          "ANY_ADDITIONAL_PROPERTY": "text"
        }
      }
    ]
  },
  "result": [
    "text"
  ]
}

Success

.NET

var client = new CodeMashClient(apiKey, projectId);
var service = new CodeMashRepository<Person>(client);

var person1 = new Person { Name = "John" };
var person2 = new Person { Name = "Peter" };

var entities = new List<Person> { person1, person2 };

await service.InsertManyAsync(entities, new DatabaseInsertManyOptions());

Check the information about entities on how your class objects are serialized.

Node

PHP

use Codemash\CodemashClient;
use Codemash\CodemashDb;

class CodemashService
{
    protected CodemashDb $codemashDb;
    protected string $collectionName = '{YOUR_COLLECTION_NAME}';

    public function __construct()
    {
        $secretKey = '{YOUR_SECRET_KEY}';
        $projectId = '{YOUR_PROJECT_ID}';

        $client = new CodemashClient($secretKey, $projectId);
        $this->codemashDb = new CodemashDb($client);
    }

    public function insertEmployees()
    {
        $employees = [];
        $employees[] = ['name' => 'John', 'email' => '[e-mail]', 'address' => 'New York'];
        $employees[] = ['name' => 'Peter', 'email' => '[e-mail]', 'address' => 'Los Angeles'];
        
        $responseData = $this->codemashDb->insertMany([
        	'collectionName' => 'employees',
        	'documents' => $employees,
        ]);
    }
}