Reten Docs
Task Activities

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 — VIEW_ACTIVITIES 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>"
import axios from 'axios';

const response = await axios.get(
  'https://api.reten.ai/api/activities/tasks/ee0e8400-e29b-41d4-a716-446655440000',
  {
    headers: {
      Authorization: 'Bearer <token>',
      'x-tenant-id': '<tenant-id>',
    },
  }
);

const taskActivity = response.data;

Response 200 OK

{
  "id": "ee0e8400-e29b-41d4-a716-446655440000",
  "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"
    }
  }
}