> This page is for Plate-forme, version Hérité.
> For other versions, use one of these documentation indexes:
> - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt
> - V4 expérimental: https://next.developer.frame.io/platform/v4-experimental/llms.txt
> - Hérité: https://next.developer.frame.io/platform/v2/llms.txt

> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://next.developer.frame.io/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://next.developer.frame.io/_mcp/server.

# Utilisation des journaux d'audit

## Présentation

Frame.io prend en charge et maintient des journaux d'audit pour la grande majorité des activités dans ses applications.Cela inclut les opérations CRUD de base sur les ressources principales et certaines abstractions spéciales (par exemple `AssetVersioned`).
<Warning title="Les journaux d'audit sont tronqués après 30 jours">
  


Les journaux d'audit Frame.io sont disponibles via API pour une fenêtre glissante de 30 jours, après quoi ils sont déplacés vers un stockage à froid.Par conséquent, si vous souhaitez conserver un historique long des événements Frame.io, veillez à stocker les données historiques des journaux de manière indépendante.



</Warning>


### Portée et autorisations

Seuls les administrateurs de compte peuvent accéder aux journaux d'audit d'un compte, et tous les appels au point d'entrée des journaux d'audit doivent être étendus à un `account_id` comme suit :

```
GET https://api.frame.io/v2/accounts/:id/audit_logs
```





### Réponses





Toutes les réponses des journaux d'audit ont un format similaire :





```json
{
    "_type": "audit",
    "account_id": "<account-id>",
    "action": "<ActionTaken>",
    "actor": {
        "_type": "user",
        "id": "<user-id>",
    },
    "actor_id": "<user-id>",
    "id": "<audit-id>",
    "inserted_at": "<ISO-8601-datetime>",
    "item_id": "<resource-id>",
    "item_type": "<ResourceType>",
    "resource": {...},
    "team_id": "<team-id>",
    "updated_at": "<ISO-8601-datetime>"
}
```




<Info title="N'oubliez pas la pagination !">
  Les données de réponse des journaux d'audit peuvent être assez détaillées, assurez-vous donc de bien connaître la [pagination](/getting-started/key-concepts#pagination) !
</Info>


## Filtres

Les journaux d'audit prennent en charge différents filtres, y compris les périodes.Contrairement aux points d'entrée de [recherche](/workflows-assets/search-for-assets) de Frame.io, les filtres peuvent être envoyés uniquement comme paramètres de chaîne de requête `GET`.

Tous les filtres suivent le même formatage :





### GET + chaîne de requête





```html
GET
https://api.frame.io/accounts/:id/audit_logs?filter[filter_type1]=value1&filter[filter_type2]=value2
```




<Info title="Une valeur par type de filtre">
  Actuellement, les journaux d'audit prennent en charge une valeur par type de filtre.Si vous fournissez deux filtres du même type (par exemple `filter[action]=ActionOne&amp;filter[action]=ActionTwo`), le second filtre prévaudra.
</Info>


### Types de filtres clés





Les types de filtres clés pour filtrer et naviguer dans les journaux d'audit sont :&quot; ] } ```




| Type de filtre | Description | Exemples de Valeur |
| ------------- | ------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| `item_type` | Filtre toutes les ressources d'un seul type. | _Presentation_, _Comment_, _ReviewLink_, _Asset_ |
| `item_id` | Filtre une seule ressource spécifique, par exemple un asset ou une présentation. | _\<asset-id>_, _\<presentation-id>_ |
| `action` | Filtre une seule action, généralement associée à un `item_type` | _ProjectCreated_, _AssetVersioned_, _CommentDeleted_ |
| `actor_id` | Filtre l'ID d'un utilisateur spécifique (acteur). | _\<user-id>_ |
| `team_id` | Filtre les activités associées à une seule équipe.Ce filtre n'est utile que pour les équipes qui ont plusieurs équipes. | _\<team-id>_ |
| `inserted_at` | Filtre les événements d'audit survenant avant ou après une date et heure spécifique.Doit être au format ISO-8601, UTC. | _2022-08-25T00:00:00Z_ |




### Types d'éléments et actions




| Ressource | Actions |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Compte** | `AccountCreated`, `AccountUpdate`, `AccountLocked` |
| **Asset** | `AssetCopied`, `AssetCreated`, `AssetDeleted`, `AssetUpdated`, `AssetVersioned`, `AssetUnversioned`, `AssetLabelUpdated`, `AssetMoved`, `AssetPreserved`, `AssetPrivatized`, `AssetPublicized`, `AssetRestored` |
| **Collaborateur** | `CollaboratorCreated`, `CollaboratorDeleted` |
| **Comment** | `CommentCreated`, `CommentCompleted`, `CommentDeleted`, `CommentLiked`, `CommentUncompleted`, `CommentUnliked`, `CommentUpdated`, `ReplyCreated` |
| **Presentation** | `PresentationCreated`, `PresentationDeleted`, `PresentationUpdated` |
| **Projet** | `ProjectCreated`, `ProjectDeleted`, `ProjectMoved`, `ProjectRestored`, `ProjectUpdated` |
| ReviewLink | `ReviewLinkCreated`, `ReviewLinkDeleted`, `ReviewLinkUpdated` |
| **Équipe** | `TeamCreated`, `TeamUpdated`, `TeamDeleted` |
| **TeamMember** | `TeamMemberCreated`, `TeamMemberAccepted`, `TeamMemberDeclined`, `TeamMemberRemoved`, `TeamMemberUpdated` |




## Exemples de filtres





Tous les filtres suivent un format similaire, comme décrit ci-dessous.Voici quelques exemples ciblant des cas d'usage spécifiques qui peuvent vous aider à commencer.




| Scénario | Chaîne de requête |
| ---------------------------------------- | ----------------------------------------------------------- |
| Actions effectuées par un seul Utilisateur. | `?filter[actor_id]=<user-id>` |
| Toute l'activité sur une présentation spécifique. | `?filter[item_id]=<presentation-id>` |
| Commentaires laissés par un Utilisateur. | `?filter[action]=CommentCreated&amp;filter[actor_id]=<user-id>` |
| Toute l'activité Review Link sur une équipe. | `?filter[item_type]=ReviewLink&amp;filter[team_id]=<team-id>` |




## Périodes

Les périodes constituent un cas légèrement particulier, dans la mesure où il est nécessaire de spécifier à la fois la `inserted_at` datetime `Valeur`, et l'`op`ération à appliquer à cette datetime. Par conséquent, les requêtes de période comporteront toujours deux éléments de filtre, dont chacun sera lui-même imbriqué à côté d'un paramètre `[inserted_at]`.

Les opérations prises en charge incluent :




* **gt** : supérieur à
* **gte** : supérieur ou égal à
* **lt** : inférieur à
* **lte** : inférieur ou égal à




### Exemples de périodes




| Scénario | Chaîne de requête |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Tous les enregistrements du journal d'audit à partir d'une date. | `?filter[inserted_at][op]=gt&amp;filter[inserted_at][value]=2019-03-25T00:00:00Z` |
| Tous les fichiers chargés par un Utilisateur spécifique jusqu'à une date. | `?filter[inserted_at][op]=lt&amp;filter[inserted_at][value]=2019-03-25T00:00:00Z&amp;filter[actor_id]=<user-id>&amp;filter[action]=AssetCreated` |