Reten Docs
Actividades

Atributos de Actividad

Listar atributos resueltos de una actividad.

GET /api/activities/:id/attributes

Devuelve la lista de atributos asociados a una actividad, incluyendo su estado de resolución y valores resueltos.

Auth: Requerida — permiso VIEW_ACTIVITIES

Parámetros de Ruta

ParámetroTipoDescripción
idUUIDID de la actividad

Ejemplo

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

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

Respuesta 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"
  }
]

Campos de la Respuesta

CampoTipoDescripción
idUUIDID del registro de atributo
activityIdUUIDID de la actividad padre
attributeKeyIdUUIDReferencia a la clave de atributo global
valueany (JSON)Valor del atributo resuelto, o null si aún no se ha resuelto
resolutionStatusstringPENDING, RESOLVED, FAILED o FALLBACK
resolverTypestring | nullINTERNAL_SERVICE o CLIENT_HOOK
resolvedAtISO 8601 | nullMarca de tiempo de cuando se resolvió el atributo
errorMessagestring | nullDetalles del error si la resolución falló

Respuestas de Error

EstadoDescripción
404Actividad no encontrada