Reten Docs

Get Task Activity

Get a TASK activity with full relations.

GET /api/activities/tasks/:id

Returns a single TASK activity with route, operator, commerce, and status event details.

Auth: Required — activity:view permission

Path Parameters

ParameterTypeDescription
idUUIDActivity ID

Example

curl https://api.reten.ai/api/activities/tasks/ee0e8400-e29b-41d4-a716-446655440000 \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>" \
  -H "x-project-id: <project-id>"
const taskId = "ee0e8400-e29b-41d4-a716-446655440000";
const response = await fetch(`https://api.reten.ai/api/activities/tasks/${taskId}`, {
  headers: {
    "Authorization": "Bearer <token>",
    "x-tenant-id": "<tenant-id>",
    "x-project-id": "<project-id>",
  },
});
const task = await response.json();
import requests

task_id = "ee0e8400-e29b-41d4-a716-446655440000"
response = requests.get(
    f"https://api.reten.ai/api/activities/tasks/{task_id}",
    headers={
        "Authorization": "Bearer <token>",
        "x-tenant-id": "<tenant-id>",
        "x-project-id": "<project-id>",
    },
)
task = response.json()

Response 200 OK

{
  "id": "ee0e8400-e29b-41d4-a716-446655440000",
  "projectId": "3f6c2b1a-8d4e-4f7a-9b2c-5e1d0a7f6c34",
  "type": "TASK",
  "channel": "SALESMAN",
  "status": "DISPATCHED",
  "providerActivityId": "ext-123",
  "dispatchAttemptCount": 1,
  "taskDetails": {
    "assignedRouteId": "dd0e8400-e29b-41d4-a716-446655440000",
    "assignedOperatorId": "cc0e8400-e29b-41d4-a716-446655440000",
    "route": {
      "id": "dd0e8400-e29b-41d4-a716-446655440000",
      "name": "North Zone",
      "code": "ZONE-NORTH"
    },
    "operator": {
      "id": "cc0e8400-e29b-41d4-a716-446655440000",
      "firstName": "John",
      "lastName": "Doe",
      "type": "SALESMAN"
    }
  },
  "commerceAssignment": {
    "commerce": {
      "id": "880e8400-e29b-41d4-a716-446655440000",
      "name": "Main Street Store"
    }
  }
}