Auditoría

Historial global de incidentes y de administración.

3 endpointsGET · 3

GET/audit/catalogTipos de cada pestaña que se puede ver (la otra va en null), roles y permisos (solo con audit.admin.view) y personas

Permiso: audit.incidents.view o audit.admin.view

Cabeceras de la petición

Cabecera	Valor	Para qué
`Authorization`	`Bearer trazo_…`	Token de sesión que entrega el ingreso
`Accept`	`application/json`	La API siempre responde JSON (o un archivo, en la exportación)

Respuesta 200

Campo	Tipo
`data`	objeto
`data.incident_types`	lista de objeto \| null
`data.incident_types[].code`	texto
`data.incident_types[].name`	texto
`data.admin_types`	lista de objeto \| null
`data.admin_types[].code`	texto
`data.admin_types[].name`	texto
`data.roles`	lista de objeto
`data.roles[].code`	texto
`data.roles[].name`	texto
`data.permissions`	lista de objeto
`data.permissions[].code`	texto
`data.permissions[].name`	texto
`data.people`	lista de objeto

{
  "data": {
    "incident_types": [
      {
        "code": "in_progress",
        "name": "Andrés Castro"
      }
    ],
    "admin_types": [
      {
        "code": "in_progress",
        "name": "Andrés Castro"
      }
    ],
    "roles": [
      {
        "code": "in_progress",
        "name": "Andrés Castro"
      }
    ],
    "permissions": [
      {
        "code": "in_progress",
        "name": "Andrés Castro"
      }
    ],
    "people": [
      "texto"
    ]
  }
}

Cabecera de la respuesta	Para qué
`X-Request-Id`	Identificador de la petición; es el trace_id de los errores

Errores posibles

401Sin sesión o la sesión expiró (UNAUTHENTICATED)

Todos llegan en formato RFC 9457 con su code y trace_id: ver Errores de la API.

Ver el módulo en la biblioteca

GET/audit/incidentsHistorial de todos los incidentes, también de los eliminados

Permiso: audit.incidents.view

Cabeceras de la petición

Cabecera	Valor	Para qué
`Authorization`	`Bearer trazo_…`	Token de sesión que entrega el ingreso
`Accept`	`application/json`	La API siempre responde JSON (o un archivo, en la exportación)

Parámetros

Nombre	Dónde	Tipo	Obligatorio
`per_page`	Consulta	entero · ≥ 1 · ≤ 100	No
`cursor`	Consulta	texto · máx. 100	No
`filter[from]`	Consulta	texto · date-time	No
`filter[to]`	Consulta	texto · date-time	No
`filter[actor]`	Consulta	texto	No
`filter[type][]`	Consulta	lista de texto	No
`filter[incident]`	Consulta	texto · máx. 20	No

Respuesta 200

Campo	Tipo
`data`	lista de objeto
`meta`	objeto
`meta.next_cursor`	texto \| null
`meta.from`	texto
`meta.to`	texto

{
  "data": [
    "texto"
  ],
  "meta": {
    "next_cursor": "texto",
    "from": "texto",
    "to": "texto"
  }
}

Cabecera de la respuesta	Para qué
`X-Request-Id`	Identificador de la petición; es el trace_id de los errores

Errores posibles

401Sin sesión o la sesión expiró (UNAUTHENTICATED)
403Sin permiso para esta acción
422Algún dato no es válido (VALIDATION_FAILED, con el detalle por campo)

Todos llegan en formato RFC 9457 con su code y trace_id: ver Errores de la API.

Ver el módulo en la biblioteca

GET/audit/adminRegistro de administración dentro del alcance de quien consulta

Permiso: audit.admin.view

Cabeceras de la petición

Cabecera	Valor	Para qué
`Authorization`	`Bearer trazo_…`	Token de sesión que entrega el ingreso
`Accept`	`application/json`	La API siempre responde JSON (o un archivo, en la exportación)

Parámetros

Nombre	Dónde	Tipo	Obligatorio
`per_page`	Consulta	entero · ≥ 1 · ≤ 100	No
`cursor`	Consulta	texto · máx. 100	No
`filter[from]`	Consulta	texto · date-time	No
`filter[to]`	Consulta	texto · date-time	No
`filter[actor]`	Consulta	texto	No
`filter[type][]`	Consulta	lista de texto	No
`filter[user]`	Consulta	texto	No
`filter[role]`	Consulta	texto · máx. 40	No

Respuesta 200

Campo	Tipo
`data`	lista de objeto
`meta`	objeto
`meta.next_cursor`	texto \| null
`meta.from`	texto
`meta.to`	texto

{
  "data": [
    "texto"
  ],
  "meta": {
    "next_cursor": "texto",
    "from": "texto",
    "to": "texto"
  }
}

Cabecera de la respuesta	Para qué
`X-Request-Id`	Identificador de la petición; es el trace_id de los errores

Errores posibles

401Sin sesión o la sesión expiró (UNAUTHENTICATED)
403Sin permiso para esta acción
422Algún dato no es válido (VALIDATION_FAILED, con el detalle por campo)

Todos llegan en formato RFC 9457 con su code y trace_id: ver Errores de la API.

Ver el módulo en la biblioteca