Skip to main content
POST
Bulk create items

Authorizations

X-API-Key
string
header
required

API key for authentication

Path Parameters

task_uuid
string
required

Annotation task to act on

Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

Body

application/json
items
AnnotationItemPayload · object[]
required

Items to insert. Insertion order is preserved

annotator_id
string | null

Annotator these initial annotations belong to. Required when any item carries annotations

Required string length: 36
Example:

"f47ac10b-58cc-4372-a567-0e02b2c3d479"

Response

Successful Response

item_ids
string[]
required

IDs of every item the request resolved to, in request order

Example:
count
integer
required

How many items the request resolved to

new_item_ids
string[] | null

IDs of the items that were newly created

existing_item_ids
string[] | null

IDs of items that already existed by name and were reused

annotation_job_id
string | null

ID of the labelling job that holds the annotations you provided, present only when you send annotations with the items