Reten Docs
Atividades

Eventos de Status

Obter o histórico de eventos de status de uma atividade.

GET /api/activities/:id/status-events

Retorna a trilha de auditoria completa das transições de status de uma atividade. Os valores de fromStatus e toStatus correspondem à state machine operacional — veja Activity States para o catálogo e as transições válidas.

Auth: Obrigatório — permissão activity:view

Parâmetros de Rota

ParâmetroTipoDescrição
idUUIDID da atividade

Exemplo

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

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

Resposta 200 OK

[
  {
    "id": "ff0e8400-e29b-41d4-a716-446655440000",
    "eventType": "CREATED",
    "fromStatus": null,
    "toStatus": "READY",
    "errorCode": null,
    "errorMessage": null,
    "occurredAt": "2025-01-15T10:30:00.000Z"
  },
  {
    "id": "ff1e8400-e29b-41d4-a716-446655440001",
    "eventType": "DISPATCH_SUCCESS",
    "fromStatus": "READY",
    "toStatus": "DISPATCHED",
    "errorCode": null,
    "errorMessage": null,
    "occurredAt": "2025-01-15T10:31:00.000Z"
  }
]

Forçar Nova Tentativa de Despacho

Tentar novamente o despacho de uma atividade em status FAILED. Ação administrativa que ignora a state machine e reseta a atividade para READY para um despacho imediato.

Listar Atividades de Tarefa

Obter uma lista paginada de atividades TASK com filtros de rota/operador.