Create Multiple Entity Records

Creates multiple new Entity records in a batch.

API Endpoint

BaseURL/EntityService/<Entity>/insert-batch

• BaseURL:

Request Headers

Header	Value
Authorization	Bearer <access_token>
Content-Type	application/json

Note:

Replace all the values between the angle brackets <...> with their corresponding use-case values.

The <access_token> is the one you received when you authorized the external application. It is available for 1 hour, then you need to generate a new one, or request a refresh token.

Query Parameters

Query Parameter	Data Type	Description	Default Value
expansionLevel (Optional)	int32	Specifies the depth of the related records to be retrieved. The value of this parameter can be 1, 2, or 3.	2
failOnFirst (Optional)	boolean	Specifies if the Data Service should stop processing the remaining records when a record fails to process. If set to true, Data Service will stop processing the remaining records at the first failure.	false

Request Body (Required)

[
  {
    "ClosingDate": "2021-03-04",
    "CreatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "CreateTime": "2021-03-04T10:36:28.230Z",
    "Logo": {
      "Name": "string",
      "Path": "string",
      "Size": 0,
      "Type": "string"
    },
    "Name": "string",
    "Nations": 0,
    "OlymipcsVersion": 0,
    "OpeningDate": "2021-03-04",
    "UpdatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "UpdateTime": "2021-03-04T10:36:28.230Z"
  },
  {
    "ClosingDate": "2021-03-04",
    "CreatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "CreateTime": "2021-03-04T10:36:28.230Z",
    "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "Logo": {
      "Name": "string",
      "Path": "string",
      "Size": 0,
      "Type": "string"
    },
    "Name": "string",
    "Nations": 0,
    "OlymipcsVersion": 0,
    "OpeningDate": "2021-03-04",
    "UpdatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "UpdateTime": "2021-03-04T10:36:28.230Z"
  }
]

Responses

200 OK

{
  "successRecords": [
    {
      "ClosingDate": "2021-03-04",
      "CreatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "CreateTime": "2021-03-04T10:36:28.236Z",
      "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "Logo": {
        "Name": "string",
        "Path": "string",
        "Size": 0,
        "Type": "string"
      },
      "Name": "string",
      "Nations": 0,
      "OlymipcsVersion": 0,
      "OpeningDate": "2021-03-04",
      "UpdatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "UpdateTime": "2021-03-04T10:36:28.236Z"
    }
  ],
  "failureRecords": {
    "error": "string",
    "record": {
      "ClosingDate": "2021-03-04",
      "CreatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "CreateTime": "2021-03-04T10:36:28.236Z",
      "Id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "Logo": {
        "Name": "string",
        "Path": "string",
        "Size": 0,
        "Type": "string"
      },
      "Name": "string",
      "Nations": 0,
      "OlymipcsVersion": 0,
      "OpeningDate": "2021-03-04",
      "UpdatedBy": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "UpdateTime": "2021-03-04T10:36:28.236Z"
    }
  }
}

401 Unauthorized

You are not authenticated to access Data Service. Make sure your Assistant or Robot is connected to a modern folder in your account.

403 Forbidden

You don't have permission to access the entity, field or record or you are using an unsupported robot type. Please contact your administrator for necessary permissions.