Sistema

Salud, eventos, acciones del Super admin y el propio contrato.

10 endpointsGET · 5PATCH · 1POST · 2DELETE · 1PUT · 1

GET/system/healthPanel de salud

Permiso: system.health.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.checked_at`	texto
`data.status`	texto
`data.components`	lista de objeto
`data.maintenance`	objeto \| null
`data.maintenance.since`	texto
`data.maintenance.enabled_by`	texto
`data.app`	objeto
`data.app.environment`	texto
`data.app.laravel`	texto
`data.app.php`	texto

{
  "data": {
    "checked_at": "2026-11-01T14:30:00Z",
    "status": "in_progress",
    "components": [
      "texto"
    ],
    "maintenance": {
      "since": "2026-11-01T14:30:00Z",
      "enabled_by": "texto"
    },
    "app": {
      "environment": "texto",
      "laravel": "texto",
      "php": "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/system/eventsEventos por cursor, con filtros

Permiso: system.logs.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[status][]`	Consulta	lista de objeto	No
`filter[severity][]`	Consulta	"info" \| "warning" \| "critical"	No
`filter[type][]`	Consulta	lista de texto	No

Respuesta 200

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

{
  "data": [
    "texto"
  ],
  "meta": {
    "next_cursor": "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/system/events/typesCatálogo de tipos, para el filtro

Permiso: system.logs.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`	lista de objeto

{
  "data": [
    "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

PATCH/system/events/{event}Cambiar el estado (status)

Permiso: system.logs.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)
`Content-Type`	`application/json`	Cuerpo en JSON
`X-Socket-ID`	`opcional`	Para no recibir en tiempo real el aviso de tu propio cambio

Parámetros

Nombre	Dónde	Tipo	Obligatorio
`event`	Ruta	entero	Sí

Cuerpo

Campo	Tipo	Obligatorio
`status`	"open" \| "acknowledged" \| "resolved"	Sí

{
  "status": "open"
}

Respuesta 200

Campo	Tipo
`data`	objeto
`data.id`	entero
`data.type`	objeto
`data.type.code`	texto
`data.type.name`	texto
`data.type.category`	texto
`data.type.severity`	texto
`data.message`	texto
`data.context`	objeto \| null
`data.occurrences`	entero
`data.first_seen_at`	texto
`data.last_seen_at`	texto
`data.trace_id`	texto \| null
`data.status`	texto
`data.status_changed_by`	texto \| null
`data.status_changed_at`	texto \| null

{
  "data": {
    "id": 1,
    "type": {
      "code": "in_progress",
      "name": "Andrés Castro",
      "category": "texto",
      "severity": "texto"
    },
    "message": "El correo no llega desde esta mañana.",
    "context": {},
    "occurrences": 12,
    "first_seen_at": "2026-11-01T14:30:00Z",
    "last_seen_at": "2026-11-01T14:30:00Z",
    "trace_id": "01jbzk8m3q9w2e5r7t1y4u6i0p",
    "status": "in_progress",
    "status_changed_by": "in_progress",
    "status_changed_at": "2026-11-01T14:30:00Z"
  }
}

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
404No existe o quien pregunta no puede verlo
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/system/failed-jobsLos 50 jobs fallidos más recientes y el total

Permiso: system.health.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`	lista de objeto
`meta`	objeto
`meta.total`	entero

{
  "data": [
    "texto"
  ],
  "meta": {
    "total": 12
  }
}

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

POST/system/failed-jobs/retryReintentar ids o all: true

Permiso: Acción

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)
`Content-Type`	`application/json`	Cuerpo en JSON
`X-Socket-ID`	`opcional`	Para no recibir en tiempo real el aviso de tu propio cambio

Cuerpo

Campo	Tipo	Obligatorio
`mfa_code`	texto \| null · máx. 20	No
`all`	sí/no	No
`ids`	lista de texto	No

{
  "mfa_code": "482913",
  "all": true,
  "ids": [
    "01jbzk8m3q9w2e5r7t1y4u6i0p"
  ]
}

Respuesta 200

Campo	Tipo
`data`	objeto
`data.retried`	entero

{
  "data": {
    "retried": 1
  }
}

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

DELETE/system/failed-jobs/{job}Descartar uno

Permiso: Acción

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)
`X-Socket-ID`	`opcional`	Para no recibir en tiempo real el aviso de tu propio cambio

Parámetros

Nombre	Dónde	Tipo	Obligatorio
`job`	Ruta	texto	Sí
`mfa_code`	Consulta	texto \| null · máx. 20	No

Respuesta 204

Sin cuerpo: la operación salió bien.

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
404No existe o quien pregunta no puede verlo
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

POST/system/actions/{action}restart-workers, restart-realtime o clear-cache

Permiso: Acción

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)
`Content-Type`	`application/json`	Cuerpo en JSON
`X-Socket-ID`	`opcional`	Para no recibir en tiempo real el aviso de tu propio cambio

Parámetros

Nombre	Dónde	Tipo	Obligatorio
`action`	Ruta	texto	Sí

Cuerpo

Campo	Tipo	Obligatorio
`mfa_code`	texto \| null · máx. 20	No

{
  "mfa_code": "482913"
}

Respuesta 204

Sin cuerpo: la operación salió bien.

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
404No existe o quien pregunta no puede verlo
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

PUT/system/maintenanceActivar o desactivar (enabled)

Permiso: Acción

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)
`Content-Type`	`application/json`	Cuerpo en JSON
`X-Socket-ID`	`opcional`	Para no recibir en tiempo real el aviso de tu propio cambio

Cuerpo

Campo	Tipo	Obligatorio
`mfa_code`	texto \| null · máx. 20	No
`enabled`	sí/no	Sí

{
  "mfa_code": "482913",
  "enabled": true
}

Respuesta 204

Sin cuerpo: la operación salió bien.

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/docsContrato OpenAPI en JSON (API)

Permiso: system.health.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

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