Interrogare l'Activity Feed

L'Activity Feed registra ogni azione di autenticazione, chat, file, progetto, amministrativa e di piattaforma che avviene nella tua organizzazione, in ordine cronologico inverso. Le attività sono interrogabili entro 1 minuto dal loro verificarsi e vengono conservate per 6 anni.

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

Filtrare le attività

Filtra per organizzazione, attore, tipo di attività o per una finestra temporale created_at utilizzando i sotto-parametri con notazione a punto created_at.gte, .gt, .lte e .lt. Consulta il riferimento API per il tipo e i valori accettati di ciascun parametro.

I parametri ripetibili utilizzano la sintassi di query con parentesi quadre per array: passa activity_types[]=..., actor_ids[]=... o organization_ids[]=... una volta per ciascun valore.

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"

L'Activity Feed produce centinaia di tipi di attività distinti. Consulta Query compliance activities nel riferimento API per l'elenco completo dei valori accettati da activity_types[].

Paginare i risultati

Le attività vengono restituite a partire dalla più recente, con i pareggi in created_at risolti tramite l'ID dell'attività, e limitate a limit risultati in ciascuna risposta (valore predefinito 100, massimo 5.000). Consulta il riferimento API per lo schema completo della risposta.

La Compliance API utilizza due schemi di paginazione a seconda della famiglia di endpoint:

Organizzazioni e file non sono paginati: List organizations restituisce tutti i risultati in un'unica risposta, e i file vengono recuperati individualmente tramite ID.

I cursori di paginazione e i token di pagina sono stringhe opache: restituiscili invariati. Il loro formato interno non è stabile e analizzarli causerà malfunzionamenti senza preavviso. In ciascuna richiesta può essere impostato solo uno tra after_id e before_id, ed entrambi gli schemi restituiscono has_more così sai quando fermarti.

Per scorrere le pagine delle attività:

• Passa il last_id della risposta come after_id per avanzare alla pagina successiva nell'ordine dei risultati. Con le attività ordinate dalla più recente, la pagina successiva contiene voci meno recenti.
• Passa first_id come before_id per tornare alla pagina precedente.
• Fermati quando has_more è false.

Il parametro del cursore imposta la direzione della pagina; l'ordinamento dell'endpoint imposta la direzione temporale. Lo stesso parametro after_id qui raggiunge attività meno recenti. Le chat sono ordinate dalla meno recente; consulta Recuperare ed eliminare chat, file e progetti per la semantica dei cursori in quel contesto.

# Recupera la prima pagina (attività più recenti per prime) e cattura il suo cursore finale.
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')

# Passa nuovamente il cursore invariato per recuperare la pagina successiva (più vecchia).
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 ciclo di backfill in produzione scorre le pagine delle attività meno recenti guidando l'iterazione tramite has_more e last_id:

1. Inizia dal cursore memorizzato (oppure ometti after_id per iniziare dall'inizio).
2. Scorri le pagine con after_id=<last_id> finché has_more non è false.
3. Salva in modo persistente il last_id finale solo dopo aver memorizzato ogni pagina che esso copre.

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)

Comprendere l'oggetto Activity

Ogni voce in data è un oggetto Activity con questa struttura di primo livello:

Il campo actor è un'unione discriminata. Il discriminatore type indica quali altri campi sono presenti:

Passaggi successivi