Skip to navigation

Create

Creates a new OperationsTask on an Order where the caller is coordinator or executor. Uses the explicit department_id or leaves the task unassigned. | authz_personas=[coordinator_org_operators, order_executor_org_operators] | (OperationsTaskClientCreate1) -> (PydanticObjectId)

Authentication

AuthorizationBearer

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

Request

This endpoint expects an object.
descriptionstringRequired<=8192 characters
order_idstringRequired
schema_versionintegerRequired
task_typeenumRequired

Coarse functional buckets a dispatcher batch-processes (powers the per-type functional-queue index). Granular SOP specifics live in the Task's title/description, not here.

Ordered roughly along the shipment lifecycle (review -> research -> book -> track/verify -> contact -> billing). The buckets are the distinct modes of work an operator sits down and batches; the exact SOP step (e.g. "Send Shipping Label", "CBC Call", "Get Pack Time") is captured in the title.

Contact is split by who (customer, agent, airline, other), not by channel (call vs. email) — the recipient is what a dispatcher batches around, and the channel is captured in title/description detail.

titlestringRequired<=512 characters
assigned_user_idslist of stringsOptional
deadline_timestampdatetimeOptional
department_idstringOptional

Response

Successful Response

Errors

422
Operations Tasks Create V1request Unprocessable Entity Error