Reten Docs
Activities

Activity Attributes

List resolved attributes for an activity.

GET /api/activities/:id/attributes

Returns the list of attributes associated with an activity, including their resolution status and resolved values.

Auth: Required — VIEW_ACTIVITIES permission

Path Parameters

ParameterTypeDescription
idUUIDActivity ID

Example

curl https://api.reten.ai/api/activities/ee0e8400-e29b-41d4-a716-446655440000/attributes \
  -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/ee0e8400-e29b-41d4-a716-446655440000/attributes',
  {
    headers: {
      Authorization: 'Bearer <token>',
      'x-tenant-id': '<tenant-id>',
    },
  }
);

const attributes = response.data;

Response 200 OK

[
  {
    "id": "ff0e8400-e29b-41d4-a716-446655440001",
    "activityId": "ee0e8400-e29b-41d4-a716-446655440000",
    "attributeKeyId": "ab0e8400-e29b-41d4-a716-446655440000",
    "value": {
      "name": "Main Street Store",
      "taxId": "12345678-9",
      "address": "123 Main St"
    },
    "resolutionStatus": "RESOLVED",
    "resolverType": "INTERNAL_SERVICE",
    "resolvedAt": "2025-01-16T09:01:00.000Z",
    "errorMessage": null,
    "createdAt": "2025-01-16T09:00:00.000Z",
    "updatedAt": "2025-01-16T09:01:00.000Z"
  },
  {
    "id": "ff0e8400-e29b-41d4-a716-446655440002",
    "activityId": "ee0e8400-e29b-41d4-a716-446655440000",
    "attributeKeyId": "ab0e8400-e29b-41d4-a716-446655440001",
    "value": null,
    "resolutionStatus": "PENDING",
    "resolverType": null,
    "resolvedAt": null,
    "errorMessage": null,
    "createdAt": "2025-01-16T09:00:00.000Z",
    "updatedAt": "2025-01-16T09:00:00.000Z"
  }
]

Response Fields

FieldTypeDescription
idUUIDAttribute record ID
activityIdUUIDParent activity ID
attributeKeyIdUUIDReference to the global attribute key
valueany (JSON)Resolved attribute value, or null if not yet resolved
resolutionStatusstringPENDING, RESOLVED, FAILED, or FALLBACK
resolverTypestring | nullINTERNAL_SERVICE or CLIENT_HOOK
resolvedAtISO 8601 | nullTimestamp when the attribute was resolved
errorMessagestring | nullError details if resolution failed

Error Responses

StatusDescription
404Activity not found