¿Cómo abro y cierro un incidente desde un script o una pipeline de despliegue?

Abre uno con POST /api/v1/services/{slug}/incidents, guarda el id devuelto y ciérralo con PATCH /api/v1/incidents/{id}/close.

Antes de empezar

• Tienes una clave de la interfaz de programación de aplicaciones (API) para el servicio.

Pasos

1. Abre el incidente:

   curl -X POST https://statusraptor.com/api/v1/services/acme-cloud/incidents \
     -H "Authorization: Bearer $STATUS_RAPTOR_KEY" \
     -H "Content-Type: application/json" \
     -d '{"title": "Checkout is failing", "status": "CRITICAL", "message": "Investigating."}'
   

   La respuesta contiene {"id": "<uuid>", "title": "...", "open": true}.

2. Ciérralo con el id devuelto:

   curl -X PATCH https://statusraptor.com/api/v1/incidents/<uuid>/close \
     -H "Authorization: Bearer $STATUS_RAPTOR_KEY"
   

Preguntas

¿Por qué el estado tiene que ir en mayúsculas aquí?

Para los incidentes, status debe ser el nombre exacto en mayúsculas, por ejemplo CRITICAL.

¿Qué hace el cierre?

Lo mismo que en el panel de gestión: Status Raptor publica actualizaciones «Resolved» y envía el correo de incidente cerrado.