Consultar el Feed de Actividad

El Feed de Actividad registra cada acción de autenticación, chat, archivo, proyecto, administración y plataforma que ocurre en tu organización, en orden cronológico inverso. Las actividades se pueden consultar dentro de 1 minuto después de ocurrir y se conservan durante 6 años.

curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/activities?limit=1" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

{
  "data": [
    {
      "id": "activity_01XyDMpzjS89pFZXqSFUBDr6",
      "created_at": "2026-04-10T08:09:10Z",
      "organization_id": "org_01Wv6QeBcDfGhJkLmNpQrSt8",
      "organization_uuid": "abcdef01-2345-6789-abcd-ef0123456789",
      "actor": {
        "type": "user_actor",
        "email_address": "[email protected]",
        "user_id": "user_01TuVwXyZaBcDeFgH2JkLmN4",
        "ip_address": "192.0.2.34",
        "user_agent": "Mozilla/5.0..."
      },
      "type": "claude_chat_created",
      "claude_chat_id": "claude_chat_01XyDMpzjS89pFZXqSFUBDr6",
      "claude_project_id": "claude_proj_01KGp4eZNug9ri4kE35RSppq"
    }
  ],
  "has_more": true,
  "first_id": "activity_01XyDMpzjS89pFZXqSFUBDr6",
  "last_id": "activity_01XyDMpzjS89pFZXqSFUBDr6"
}

Filtrar actividades

Filtra por organización, actor, tipo de actividad o una ventana de tiempo de created_at usando los subparámetros con notación de punto created_at.gte, .gt, .lte y .lt. Consulta la referencia de la API para conocer el tipo y los valores aceptados de cada parámetro.

Los parámetros repetibles usan sintaxis de consulta con corchetes de arreglo: pasa activity_types[]=..., actor_ids[]=... u organization_ids[]=... una vez por cada valor.

curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/activities" \
  --data-urlencode "activity_types[]=claude_file_uploaded" \
  --data-urlencode "activity_types[]=claude_chat_created" \
  --data-urlencode "created_at.gte=2026-04-01T00:00:00Z" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY"

El Feed de Actividad produce cientos de tipos de actividad distintos. Consulta Query compliance activities en la referencia de la API para ver la lista completa de valores que acepta activity_types[].

Paginar resultados

Las actividades se devuelven de la más reciente a la más antigua, con empates en created_at resueltos por ID de actividad, y limitadas a limit resultados en cada respuesta (100 por defecto, máximo 5,000). Consulta la referencia de la API para ver el esquema completo de la respuesta.

La Compliance API usa dos esquemas de paginación según la familia de endpoints:

Las organizaciones y los archivos no se paginan: Listar organizaciones devuelve todos los resultados en una sola respuesta, y los archivos se recuperan individualmente por ID.

Los cursores de paginación y los tokens de página son cadenas opacas: devuélvelos sin modificar. Su formato interno no es estable, y analizarlos hará que tu código falle sin previo aviso. Solo se puede establecer uno de after_id o before_id en cada solicitud, y ambos esquemas devuelven has_more para que sepas cuándo detenerte.

Para recorrer las páginas de actividades:

• Pasa el last_id de la respuesta como after_id para avanzar a la siguiente página en el orden de resultados. Con las actividades ordenadas de la más reciente a la más antigua, la siguiente página contiene entradas más antiguas.
• Pasa first_id como before_id para regresar a la página anterior.
• Detente cuando has_more sea false.

El parámetro de cursor establece la dirección de la página; el orden de clasificación del endpoint establece la dirección temporal. El mismo parámetro after_id alcanza actividades más antiguas aquí. Los chats se ordenan del más antiguo al más reciente; consulta Recuperar y eliminar chats, archivos y proyectos para conocer la semántica del cursor en ese caso.

# Obtén la primera página (actividades más recientes primero) y captura su cursor final.
last_id=$(curl --fail-with-body -sS \
  "https://api.anthropic.com/v1/compliance/activities?limit=2" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" | jq -er '.last_id')

# Pasa el cursor de vuelta sin cambios para obtener la siguiente página (más antigua).
curl --fail-with-body -sS -G \
  "https://api.anthropic.com/v1/compliance/activities" \
  --header "x-api-key: $ANTHROPIC_COMPLIANCE_ACCESS_KEY" \
  --data-urlencode "limit=2" \
  --data-urlencode "after_id=${last_id}"

Un bucle de backfill (relleno retroactivo) en producción recorre las actividades más antiguas controlando la iteración con has_more y last_id:

1. Comienza desde tu cursor almacenado (u omite after_id para comenzar desde el principio).
2. Recorre las páginas con after_id=<last_id> hasta que has_more sea false.
3. Persiste el last_id final solo después de haber almacenado todas las páginas que cubre.

cursor = stored_cursor
loop:
  if cursor is not null:
    page = GET /v1/compliance/activities?after_id={cursor}&limit=100
  else:
    page = GET /v1/compliance/activities?limit=100
  store(page.data)
  if page.last_id is not null:
    cursor = page.last_id
  if not page.has_more: break
persist(cursor)

Entender el objeto Activity

Cada entrada en data es un objeto Activity con esta estructura de nivel superior:

El campo actor es una unión discriminada. El discriminador type te indica qué otros campos están presentes:

Próximos pasos