Get a work item with its concurrency tokens
curl --request GET \
--url https://useorgx.com/api/v1/work/{taskId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://useorgx.com/api/v1/work/{taskId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://useorgx.com/api/v1/work/{taskId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"id": "7fbb727d-17c4-4bc7-9fc7-60eb15e9314d",
"title": "Review the launch plan",
"description": null,
"status": "todo",
"priority": "medium",
"due_date": null,
"initiative_id": "4b014796-6b1e-4a4f-9a35-2b6a4d1c8a10",
"workstream_id": "9c1f2e77-3c58-4a1e-9d0b-6a2f8e4b1c33",
"milestone_id": null,
"sequence": 1,
"metadata": {},
"created_at": "2026-08-19T14:00:00.000Z",
"updated_at": "2026-08-19T14:02:11.442Z",
"concurrency": {
"version_token": "v1.eyJ3IjoiNWJlMTA3NmQtOGZkMC00YzBmLTg0N2YtZmQ2N2ZkYjkzNWU4IiwidCI6IjdmYmI3MjdkLTE3YzQtNGJjNy05ZmM3LTYwZWIxNWU5MzE0ZCIsInUiOiIyMDI2LTA4LTE5VDE0OjAyOjExLjQ0MjM5MSswMDowMCIsImEiOjN9.rM2gM5aF7Dva467l_-U_LGzrOyWRJIkpXciZ1NORUH4",
"expected_updated_at": "2026-08-19T14:02:11.442Z",
"expected_aggregate_version": 3
}
},
"meta": {
"apiVersion": "1",
"workspaceId": "5be1076d-8fd0-4c0f-847f-fd67fdb935e8"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}Work
Get a work item with its concurrency tokens
Read one work item you own, together with the concurrency block that
POST /work/{taskId}/complete accepts.
Echo the token unmodified
version_token is an opaque, workspace- and task-bound value. Send it back exactly as
received; do not parse or reformat it. Timestamp and aggregate-version fields from the
earlier response shape remain available for migrating clients.
Scope
Work is owner-scoped inside a workspace. An id you cannot read is reported the same way an id that was never issued is.
GET
/
work
/
{taskId}
Get a work item with its concurrency tokens
curl --request GET \
--url https://useorgx.com/api/v1/work/{taskId} \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://useorgx.com/api/v1/work/{taskId}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://useorgx.com/api/v1/work/{taskId}"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"data": {
"id": "7fbb727d-17c4-4bc7-9fc7-60eb15e9314d",
"title": "Review the launch plan",
"description": null,
"status": "todo",
"priority": "medium",
"due_date": null,
"initiative_id": "4b014796-6b1e-4a4f-9a35-2b6a4d1c8a10",
"workstream_id": "9c1f2e77-3c58-4a1e-9d0b-6a2f8e4b1c33",
"milestone_id": null,
"sequence": 1,
"metadata": {},
"created_at": "2026-08-19T14:00:00.000Z",
"updated_at": "2026-08-19T14:02:11.442Z",
"concurrency": {
"version_token": "v1.eyJ3IjoiNWJlMTA3NmQtOGZkMC00YzBmLTg0N2YtZmQ2N2ZkYjkzNWU4IiwidCI6IjdmYmI3MjdkLTE3YzQtNGJjNy05ZmM3LTYwZWIxNWU5MzE0ZCIsInUiOiIyMDI2LTA4LTE5VDE0OjAyOjExLjQ0MjM5MSswMDowMCIsImEiOjN9.rM2gM5aF7Dva467l_-U_LGzrOyWRJIkpXciZ1NORUH4",
"expected_updated_at": "2026-08-19T14:02:11.442Z",
"expected_aggregate_version": 3
}
},
"meta": {
"apiVersion": "1",
"workspaceId": "5be1076d-8fd0-4c0f-847f-fd67fdb935e8"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"details": {},
"requestId": "<string>",
"timestamp": "2023-11-07T05:31:56Z",
"docsUrl": "<string>",
"retryAfter": 123
}
}Authorizations
bearerAuthcookieAuth
OrgX API key, sent as Authorization: Bearer oxk_...
Path Parameters
Work item to read