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 sont interrogeables dans la minute qui suit 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 par une fenêtre temporelle created_at en utilisant les sous-paramètres à points created_at.gte, .gt, .lte et .lt. Consultez la référence API pour 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 API pour la liste complète des valeurs acceptées par activity_types[].



Paginer les résultats

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

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

Les fichiers ne sont pas paginés : ils sont récupérés individuellement par ID.

Les curseurs de pagination et les jetons de page sont des chaînes opaques : renvoyez-les sans les modifier. Leur format interne n'est pas stable, et leur analyse cessera de fonctionner 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 pages d'activités :

• 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 des plus récentes aux plus anciennes, 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 est 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 des plus anciens aux plus récents ; consultez Récupérer et supprimer des chats, fichiers et projets pour la sémantique des curseurs à cet endroit.

# Récupérez la première page (activités les plus récentes en premier) 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')

# Repassez 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 backfill (rattrapage) 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 soit false.
3. Ne persistez le last_id final qu'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 Activity avec cette structure de premier niveau :

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



Prochaines étapes