Reten Docs
Activities

Retry Resolution

Retry target user and attribute resolution for an UNRESOLVED activity.

PATCH /api/activities/:id/retry-resolution

Retry resolving failed target users and attributes for an activity in UNRESOLVED status. If all pending items resolve successfully, the activity transitions back to READY.

Auth: Required — CREATE_ACTIVITY permission

Path Parameters

ParameterTypeDescription
idUUIDActivity ID

Example

curl -X PATCH https://api.reten.ai/api/activities/ee0e8400-e29b-41d4-a716-446655440000/retry-resolution \
  -H "Authorization: Bearer <token>" \
  -H "x-tenant-id: <tenant-id>"
import axios from 'axios';

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

const activity = response.data;
// activity.status will be "READY" on success or remain "UNRESOLVED" on failure

Response 200 OK

{
  "id": "ee0e8400-e29b-41d4-a716-446655440000",
  "type": "TASK",
  "channel": "SALESMAN",
  "status": "READY",
  "scheduledAt": "2025-01-16T09:00:00.000Z",
  "createdAt": "2025-01-15T10:30:00.000Z",
  "updatedAt": "2025-01-15T10:35:00.000Z"
}

Behavior

  • On success: All failed target users and attributes are resolved. Activity transitions from UNRESOLVED to READY. A RESOLUTION_RETRY_SUCCESS status event is recorded.
  • On failure: Some items remain unresolved. Activity stays in UNRESOLVED status. A RESOLUTION_RETRY_FAILED status event is recorded.

Error Responses

StatusDescription
400Activity is not in UNRESOLVED status
404Activity not found