Skip to main content
POST
cURL
Use bulk create when setting up a new agent with a complete set of dispositions, or when importing a disposition configuration from another source. Either all dispositions are created and linked, or none are — partial results are not possible.
Each item places its disposition in a category the same way Create Disposition does: pass category_id (preferred) or a category name, at most one of the two — an item carrying both fails the whole request with a 400 error. Items omitting both go to the agent’s General category. See Extraction Categories.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Bulk-create dispositions for an agent.

Request body for atomically creating multiple dispositions linked to an agent.

agent_id
string<uuid>
required

The agent all dispositions will be linked to.

dispositions
object[]
required

Non-empty array of disposition objects to create.

Minimum array length: 1

Response

Dispositions created successfully

Response returned after a successful bulk-create. The ids array preserves the input order.

message
string
Example:

"Dispositions created successfully"

ids
string<uuid>[]

IDs of the newly created dispositions, in the same order as the input dispositions array.

Example: