Get

GET

/operations/operations_tasks/v1/:task_id

GET

/operations/operations_tasks/v1/:task_id

1 import { ChrtClient } from "@chrt-inc/typescript-sdk";
2 
3 async function main() {
4     const client = new ChrtClient({
5         token: "YOUR_TOKEN_HERE",
6     });
7     await client.operations.operationsTasks.getV1("task_id");
8 }
9 main();

1 {
2   "schema_version": 1,
3   "order_id": "order_id",
4   "task_type": "review_order_details",
5   "title": "title",
6   "description": "description",
7   "_id": "_id",
8   "org_id": "org_id",
9   "deadline_timestamp": "2024-01-15T09:30:00Z",
10   "tags": [
11     "tags"
12   ],
13   "assigned_user_ids": [
14     "assigned_user_ids"
15   ],
16   "department_id": "department_id",
17   "source_task_list_id": "source_task_list_id",
18   "status": "not_started",
19   "completed_at_timestamp": "2024-01-15T09:30:00Z",
20   "completed_by_user_id": "completed_by_user_id",
21   "comments": [
22     {
23       "comment": "comment",
24       "user_id": "user_id",
25       "timestamp": "2024-01-15T09:30:00Z",
26       "id": "id"
27     }
28   ]
29 }

Retrieves a single OperationsTask by id. | authz: min_org_role=operator | () -> (OperationsTask1)

Authentication

AuthorizationBearer

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

Path parameters

task_idstringRequired

Response

Successful Response

schema_versioninteger

order_idstring

task_typeenum

Coarse functional buckets a dispatcher batch-processes (powers the per-type functional-queue index). Granular SOP specifics live in the Task’s title/description + tags, 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 a title/tag detail.

titlestring<=512 characters

descriptionstring<=8192 characters

_idstring

org_idstring

Must be a string starting with org_

deadline_timestampdatetime

tagslist of strings

assigned_user_idslist of strings

department_idstring or null

source_task_list_idstring or null

statusenum

Operator-driven lifecycle of an operations task.

Manually driven by operators for now (no automatic transitions). Kept structurally parallel to the Check status model in anticipation of the eventual Task <-> Check merge.

completed_at_timestampdatetime or null

completed_by_user_idstring or null

Must be a string starting with user_

commentslist of objects

Errors

422

Operations Tasks Get V1request Unprocessable Entity Error