/tasks

Create a one-off work task bound to a platform entity (by ORN) and assigned to an organization, team, or user scope. The referenced entity must exist and belong to your organization; a dead reference is rejected. The optional form definition is snapshotted onto the task, and a completion is validated against that stored snapshot.

Author-facing strings (task name, description, form labels, descriptions, placeholders, display texts, select option labels, step titles, validator messages, and string presets) may contain Liquid template expressions. They are resolved against the referenced entity once, at creation; the stored task never changes when the entity changes afterwards. The available root variable follows the ORN type: tour, shipment, carrier, or draft; a load ORN provides shipment and load; a stop ORN (orn::tour/

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
assignee
required

Who the task is assigned to: an organization, team, or user scope on the operator, carrier, or shipper side.

string
required

ORN of the platform entity this task is about (e.g. orn::tour/QSU1Y). Supported types: tour, shipment, draft, carrier, load, stop. A stop ORN names the stop by its stable id (orn::tour/QSU1Y/stop/

boolean

When true, completion is accepted only from a signed-in human user; machine actors (API keys, automations, agents) are rejected. Defaults to false.

string
required
length between 1 and 200

Short display name of the task (1-200 characters).

string
length ≤ 5000

Longer description of what needs to be done. Up to 5000 characters.

integer
≤ 9007199254740991

Epoch-seconds timestamp the task is due at. Omit for no due date.

boolean

Whether the task may be skipped without being completed. Defaults to false.

boolean

Whether an open instance of this task blocks the flow it gates (e.g. advancing the referenced tour). Defaults to false.

form
object

The form to fill for completion, snapshotted onto the task at creation. Absent for tasks without a form; completion then takes no form output.

snoozes
object

Per-actor snoozes: a map from the snoozing actor's scope key (for example operator-user#, or api-key# where id is the key's stable non-secret identifier) to the epoch-seconds timestamp the snooze ends. A snooze hides the task from that actor's default listings only; it ends at the task's due date at the latest. Absent when nobody has snoozed the task.

integer
-9007199254740991 to 9007199254740991

Epoch-seconds timestamp when the task was deleted, by the system because the stop it referenced left its tour or the tour was cancelled or deleted, or through the API. Present only on tasks with status deleted.

Responses

400

bad request - invalid task config or unknown referenced entity

401

unauthorized

Language
Credentials
Header
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json