> This page is for Plataforma, version Heredado.
> 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
> - Heredado: 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.

# Cómo trabajar con registros de auditoría

## Información general

Frame.io admite y mantiene registros de auditoría para la gran mayoría de las actividades que se realizan en sus aplicaciones. Esto incluye tanto operaciones CRUD básicas en activos principales como algunas abstracciones especiales (por ejemplo, `AssetVersioned`).
<Warning title="Los registros de auditoría se truncan después de 30 días">
  


Los registros de auditoría de Frame.io están disponibles a través de la API durante un periodo de 30 días, después del cual se trasladan al almacenamiento en frío. Por lo tanto, si desea mantener un historial largo de eventos de Frame.io, asegúrese de almacenar los datos del registro histórico de forma independiente.



</Warning>


### Ámbito y permisos

Solo los administradores de cuenta pueden acceder a los registros de auditoría de una cuenta, y todas las llamadas al punto final de registros de auditoría deben tener el ámbito de un `account_id` de la siguiente manera:

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





### Respuestas





Todas las respuestas de registro de auditoría tienen un formato similar:





```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="No olvide paginar.">
  Los datos de respuesta del registro de auditoría pueden ser bastante detallados, así que asegúrese de estar familiarizado con la [paginación](/getting-started/key-concepts#pagination).
</Info>


## Filtros

Los registros de auditoría admiten una amplia variedad de filtros, incluidos los intervalos de fecha. A diferencia de los puntos finales de [búsqueda](/workflows-assets/search-for-assets) de Frame.io, los filtros solo se pueden enviar como parámetros de cadena de consulta `GET`.

Todos los filtros siguen el mismo formato:





### GET + cadena de consulta





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




<Info title="Un valor por tipo de filtro">
  Actualmente, los registros de auditoría admiten un valor por tipo de filtro. Si proporciona dos filtros del mismo tipo (por ejemplo, `filter[action]=ActionOne&amp;filter[action]=ActionTwo`), el segundo filtro prevalecerá.
</Info>


### Tipos de filtro principales





Los tipos de filtro principales para seleccionar y navegar por los registros de auditoría son los siguientes:




| Tipo de filtro | Descripción | Valores de ejemplo |
| ------------- | ------------------------------------------------------------------------------------------------------------------- | ---------------------------------------------------- |
| `item_type` | Filtros para todos los recursos de un solo tipo. | _Presentation_, _Comment_, _ReviewLink_, _Asset_ |
| `item_id` | Filtros para un solo recurso específico, por ejemplo, un activo o una presentación. | _\<asset-id>_, _\<presentation-id>_</presentation-id></asset-id> |
| `action` | Filtros para una sola acción, normalmente asociada con un `item_type` | _ProjectCreated_, _AssetVersioned_, _CommentDeleted_ |
| `actor_id` | Filtros para el ID de un usuario específico (actor). | _\<user-id>_</user-id> |
| `team_id` | Filtros para las actividades asociadas con un solo equipo. Este filtro es útil solo en equipos que tienen varios equipos. | _\<team-id>_</team-id> |
| `inserted_at` | Filtros para eventos de auditoría que ocurren antes o después de un datetime específico. Debe estar en formato ISO-8601, UTC. | _2022-08-25T00:00:00Z_ |




### Tipos de elementos y acciones




| Recurso | Acciones |
| ---------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Cuenta** | `AccountCreated`, `AccountUpdate`, `AccountLocked` |
| **Activo** | `AssetCopied`, `AssetCreated`, `AssetDeleted`, `AssetUpdated`, `AssetVersioned`, `AssetUnversioned`, `AssetLabelUpdated`, `AssetMoved`, `AssetPreserved`, `AssetPrivatized`, `AssetPublicized`, `AssetRestored` |
| **Colaborador** | `CollaboratorCreated`, `CollaboratorDeleted` |
| **Comentario** | `CommentCreated`, `CommentCompleted`, `CommentDeleted`, `CommentLiked`, `CommentUncompleted`, `CommentUnliked`, `CommentUpdated`, `ReplyCreated` |
| **Presentación** | `PresentationCreated`, `PresentationDeleted`, `PresentationUpdated` |
| **Proyecto** | `ProjectCreated`, `ProjectDeleted`, `ProjectMoved`, `ProjectRestored`, `ProjectUpdated` |
| ReviewLink | `ReviewLinkCreated`, `ReviewLinkDeleted`, `ReviewLinkUpdated` |
| **Equipo** | `TeamCreated`, `TeamUpdated`, `TeamDeleted` |
| **TeamMember** | `TeamMemberCreated`, `TeamMemberAccepted`, `TeamMemberDeclined`, `TeamMemberRemoved`, `TeamMemberUpdated` |




## Ejemplos de filtros





Todos los filtros siguen un formato similar, como se indica arriba. A continuación, se incluyen algunos ejemplos para casos de uso específicos que pueden ayudarle a empezar.




| Escenario | Cadena de consulta |
| ---------------------------------------- | ----------------------------------------------------------- |
| Acciones que un usuario individual ha realizado. | `?filter[actor_id]=<user-id></user-id>` |
| Toda la actividad incluida en una presentación específica. | `?filter[item_id]=<presentation-id></presentation-id>` |
| Comentarios que un usuario ha dejado. | `?filter[action]=CommentCreated&amp;filter[actor_id]=<user-id></user-id>` |
| Toda la actividad del vínculo de revisión en un equipo. | `?filter[item_type]=ReviewLink&amp;filter[team_id]=<team-id></team-id>` |




## Intervalo de fechas

Los intervalos de fecha son un caso ligeramente especial, ya que es necesario especificar el datetime `inserted_at`, el `value` y la `op`eración que se aplicará a ese datetime. Por lo tanto, las consultas de intervalo de fecha siempre tendrán dos elementos de filtro, cada uno de los cuales se anidará junto a un parámetro `[inserted_at]`.

Entre las operaciones compatibles se incluyen las siguientes:




* **gt**: mayor que
* **gte**: mayor o igual que
* **lt**: menor que
* **lte**: menor o igual que




### Ejemplos de intervalos de fecha




| Escenario | Cadena de consulta |
| ---------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
| Todos los registros de auditoría de una fecha. | `?filter[inserted_at][op]=gt&amp;filter[inserted_at][value]=2019-03-25T00:00:00Z` |
| Todos los activos que un usuario específico ha cargado hasta una fecha determinada. | `?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</user-id>` |