Interroger le flux d'activité

Le flux d'activité enregistre chaque action d'authentification, de chat, de fichier, de projet, d'administration et de plateforme qui se produit dans votre organisation, dans l'ordre chronologique inverse. Les activités peuvent être interrogées dans la minute suivant leur occurrence et sont conservées pendant 6 ans.

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

Filtrer les activités

Filtrez par organisation, acteur, type d'activité ou fenêtre temporelle created_at à l'aide des sous-paramètres pointés created_at.gte, .gt, .lte et .lt. Consultez la référence de l'API pour connaître le type et les valeurs acceptées de chaque paramètre.

Les paramètres répétables utilisent la syntaxe de requête avec crochets de tableau : passez activity_types[]=..., actor_ids[]=... ou organization_ids[]=... une fois pour chaque valeur.

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"

Le flux d'activité produit des centaines de types d'activité distincts. Consultez Interroger les activités de conformité dans la référence de l'API pour obtenir la liste complète des valeurs acceptées par activity_types[].

Paginer les résultats

Les activités sont renvoyées de la plus récente à la plus ancienne, les égalités sur created_at étant départagées par l'identifiant d'activité, et plafonnées à limit résultats dans chaque réponse (100 par défaut, 5 000 au maximum). Consultez la référence de l'API pour le schéma de réponse complet.

L'API de conformité utilise deux schémas de pagination selon la famille de points de terminaison :

Les organisations et les fichiers ne sont pas paginés : Lister les organisations renvoie tous les résultats en une seule réponse, et les fichiers sont récupérés individuellement par identifiant.

Les curseurs de pagination et les jetons de page sont des chaînes opaques : renvoyez-les tels quels. Leur format interne n'est pas stable, et les analyser entraînera des dysfonctionnements sans préavis. Un seul des paramètres after_id ou before_id peut être défini dans chaque requête, et les deux schémas renvoient has_more pour que vous sachiez quand vous arrêter.

Pour parcourir les activités page par page :

• Passez le last_id de la réponse comme after_id pour avancer à la page suivante dans l'ordre des résultats. Les activités étant triées de la plus récente à la plus ancienne, la page suivante contient des entrées plus anciennes.
• Passez first_id comme before_id pour revenir à la page précédente.
• Arrêtez-vous lorsque has_more vaut false.

Le paramètre de curseur définit la direction de la page ; l'ordre de tri du point de terminaison définit la direction temporelle. Le même paramètre after_id atteint ici des activités plus anciennes. Les chats sont triés du plus ancien au plus récent ; consultez Récupérer et supprimer des chats, fichiers et projets pour la sémantique des curseurs dans ce contexte.

# Récupérez la première page (activités les plus récentes d'abord) et capturez son curseur de fin.
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')

# Renvoyez le curseur tel quel pour récupérer la page suivante (plus ancienne).
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}"

Une boucle de remplissage rétroactif (backfill) en production parcourt les activités plus anciennes en pilotant l'itération à partir de has_more et last_id :

1. Commencez à partir de votre curseur stocké (ou omettez after_id pour commencer depuis le début).
2. Parcourez les pages avec after_id=<last_id> jusqu'à ce que has_more vaille false.
3. Persistez le last_id final uniquement après avoir stocké chaque page qu'il couvre.

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)

Comprendre l'objet Activity

Chaque entrée dans data est une activité (Activity) avec cette structure de premier niveau :

Le champ actor est une union discriminée. Le discriminant type vous indique quels autres champs sont présents :

Étapes suivantes