> This page is for Plataforma, version Herdado.
> For other versions, use one of these documentation indexes:
> - V4 (default): https://next.developer.frame.io/platform/v4/llms.txt
> - V4 experimental: https://next.developer.frame.io/platform/v4-experimental/llms.txt
> - Herdado: 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.

# Trabalhar com logs de auditoria

## Visão geral

O Frame.io oferece suporte e mantém logs de auditoria para a maioria das atividades realizadas em seus aplicativos.Isso inclui CRUD básico em recursos principais e algumas abstrações especiais (por exemplo, `AssetVersioned`).
<Warning title="Os logs de auditoria são truncados após 30 dias">
  


Os logs de auditoria do Frame.io estão disponíveis via API para uma janela contínua de 30 dias, após a qual são movidos para armazenamento frio.Portanto, se você deseja manter um histórico longo de eventos do Frame.io, certifique-se de armazenar dados de logs históricos de forma independente.



</Warning>


### Escopo e permissões

Apenas administradores de conta podem acessar os logs de auditoria de uma conta, e todas as chamadas para o ponto de acesso de logs de auditoria devem ter escopo para um `account_id` da seguinte forma:

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





### Respostas





Todas as respostas de log de auditoria têm um formato semelhante:





```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ão se esqueça de paginar!">
  Os dados de resposta do log de auditoria podem ser bastante detalhados, então certifique-se de estar familiarizado com a [paginação](/getting-started/key-concepts#pagination)!
</Info>


## Filtros

Os logs de auditoria oferecem suporte a uma variedade de filtros, incluindo intervalos de datas.Ao contrário dos pontos de acesso de [Pesquisa](/workflows-assets/search-for-assets) do Frame.io, os filtros podem ser enviados apenas como parâmetros de string de consulta `GET`.

Todos os filtros seguem a mesma formatação:





### GET + string de consulta





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




<Info title="Um valor por tipo de filtro">
  Atualmente, os logs de auditoria oferecem suporte a um valor por tipo de filtro.Se você fornecer dois filtros do mesmo tipo (por exemplo, `filter[action]=ActionOne&amp;filter[action]=ActionTwo`), o segundo filtro terá precedência.
</Info>


### Tipos de filtro principais





Os tipos de filtro principais para selecionar e navegar pelos logs de auditoria são:




| Tipo de filtro | Descrição | Valores de exemplo |
| ------------- | ------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| `item_type` | Filtros para todos os recursos de um único tipo. | _Presentation_, _Comment_, _ReviewLink_, _Asset_ |
| `item_id` | Filtros para um único recurso específico, por exemplo, um Ativo ou Apresentação. | _\<asset-id>_, _\<presentation-id>_ |
| `action` | Filtros para uma única ação, geralmente associada a um `item_type` | _ProjectCreated_, _AssetVersioned_, _CommentDeleted_ |
| `actor_id` | Filtros para o ID de um usuário específico (ator). | _\<user-id>_ |
| `team_id` | Filtros para atividades associadas a uma única equipe.Este filtro é útil apenas em equipes que têm várias equipes. | _\<team-id>_ |
| `inserted_at` | Filtros para eventos de auditoria que ocorrem antes ou depois de uma data e hora específica.Deve estar no formato ISO-8601, UTC. | _2022-08-25T00:00:00Z_ |




### Tipos de item e ações




| Recurso | Ações |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Conta** | `AccountCreated`, `AccountUpdate`, `AccountLocked` |
| **Ativo** | `AssetCopied`, `AssetCreated`, `AssetDeleted`, `AssetUpdated`, `AssetVersioned`, `AssetUnversioned`, `AssetLabelUpdated`, `AssetMoved`, `AssetPreserved`, `AssetPrivatized`, `AssetPublicized`, `AssetRestored` |
| **Colaborador** | `CollaboratorCreated`, `CollaboratorDeleted` |
| **Comentário** | `CommentCreated`, `CommentCompleted`, `CommentDeleted`, `CommentLiked`, `CommentUncompleted`, `CommentUnliked`, `CommentUpdated`, `ReplyCreated` |
| **Apresentação** | `PresentationCreated`, `PresentationDeleted`, `PresentationUpdated` |
| **Projeto** | `ProjectCreated`, `ProjectDeleted`, `ProjectMoved`, `ProjectRestored`, `ProjectUpdated` |
| ReviewLink | `ReviewLinkCreated`, `ReviewLinkDeleted`, `ReviewLinkUpdated` |
| **Equipe** | `TeamCreated`, `TeamUpdated`, `TeamDeleted` |
| **TeamMember** | `TeamMemberCreated`, `TeamMemberAccepted`, `TeamMemberDeclined`, `TeamMemberRemoved`, `TeamMemberUpdated` |




## Exemplos de filtro





Todos os filtros seguem um formato semelhante, como descrito acima.Abaixo há alguns exemplos voltados para casos de uso específicos que podem ajudar você a começar.




| Cenário | String de consulta |
| ---------------------------------------- | ----------------------------------------------------------- |
| Ações executadas por um único usuário. | `?filter[actor_id]=<user-id>` |
| Toda a atividade em uma apresentação específica. | `?filter[item_id]=<presentation-id>` |
| Comentários deixados por um usuário. | `?filter[action]=CommentCreated&amp;filter[actor_id]=<user-id>` |
| Toda a atividade do link de revisão em uma equipe. | `?filter[item_type]=ReviewLink&amp;filter[team_id]=<team-id>` |




## Intervalos de datas

Os intervalos de datas são um caso um pouco especial, na medida em que é necessário especificar tanto o `value` de data e hora `inserted_at` quanto a `op`eração a ser aplicada a essa data e hora.Consequentemente, as consultas de intervalo de datas sempre terão dois elementos de filtro, cada um dos quais será aninhado ao lado de um parâmetro `[inserted_at]`.

As operações suportadas incluem:




* **gt**: maior que
* **gte**: maior ou igual a
* **lt**: menor que
* **lte**: menor ou igual a




### Exemplos de intervalo de datas




| Cenário | String de consulta |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Todos os registros do log de auditoria a partir de uma data. | `?filter[inserted_at][op]=gt&amp;filter[inserted_at][value]=2019-03-25T00:00:00Z` |
| Todos os ativos dos quais foi feito upload por um usuário específico até uma data. | `?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` |