Obtener incidente en PagerDuty, con una API
Devuelve un incidente con su estado, urgencia, prioridad, servicio, asignaciones, reconocimientos y política de escalado.
- Identificador
- pagerduty_get_incident
La llamada
POST https://connect.reportei.com/api/tools/pagerduty_get_incident/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"id": "<id>"
}
}Tu sistema envía el id de la conexión de tu cliente y los argumentos de la tool. Los headers son los mismos de toda la API de Connect: el token de tu producto y el token de tu cliente.
Parámetros
Las descripciones de los parámetros siguen la documentación oficial de la app, en inglés.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| id | string | Sí | Id of the incident, such as PT4KHLK, from List incidents. |
Conexiones posibles
Tu cliente conecta su cuenta de PagerDuty una sola vez, con uno de los modos de abajo. La misma conexión sirve para todas las tools del toolkit.
Clave de API
Tu cliente pega la clave de la app en una pantalla de Connect, o tu sistema envía la clave con POST /api/customer-toolkits, sin pantalla.
La respuesta
Si la llamada tiene éxito, Connect conserva el status y el cuerpo de la respuesta de la app. Los errores HTTP devueltos por la app usan el objeto {error, api_error}; la autenticación o validación pueden fallar antes de la ejecución. El header X-Toolkit-Execution-Id identifica la ejecución registrada, disponible en GET /api/tools/executions/{uuid}.
Lista para agentes de IA
El input de esta tool es un JSON Schema, disponible en GET /api/tools/pagerduty_get_incident. Se convierte en la definición de tool de tu agente sin conversión.
Otras tools de PagerDuty
- Listar incidentesGETLista los incidentes de la cuenta creados en el último mes, o en el rango de since y until. Aquí no hay filtro por estado, servicio o asignado, así que lee status, service y assignments en cada elemento. Pagina con limit y offset mientras more sea true.
- Crear incidentePOSTCrea un incidente en un servicio, lo que notifica a la política de escalado del servicio o a los usuarios en assignments. Necesita type, title y service. Envía assignments o escalation_policy, nunca ambos. Un incidente que el usuario se asigna a sí mismo empieza reconocido, sin notificarlo.
- Actualizar incidentePUTReconoce, resuelve, reasigna o escala un incidente, o cambia su título, urgencia, prioridad o servicio. Envía type y solo los campos a cambiar. Reasignar o escalar notifica a los nuevos responsables, y definir status en un incidente resuelto lo reabre.
- Listar notas del incidenteGETLista las notas de un incidente, cada una con su contenido, autor y hora de creación.
- Crear nota en el incidentePOSTAgrega una nota a un incidente, firmada por el usuario de la conexión. Un incidente admite hasta 2000 notas.
- Listar entradas de registro del incidenteGETLista la línea de tiempo de un incidente: activaciones, notificaciones, reconocimientos, asignaciones, escalados, notas y resolución, cada uno con el agente y la hora. Pagina con limit y offset mientras more sea true.
- Listar serviciosGETLista los servicios de la cuenta, cada uno con id, nombre, estado y política de escalado. El id es lo que piden Create incident y Update incident. Pagina con limit y offset mientras more sea true.
- Listar guardiasGETLista quién está de guardia, una entrada por usuario, política de escalado y nivel, con el horario cuando el turno viene de uno. Sin since y until, devuelve las guardias de este momento. Pagina con limit y offset mientras more sea true.
Toolkits de la misma categoría
Ver los 100 toolkitsMira Connect aplicado a tu producto.
Pruébalo durante 15 días sin tarjeta, o cuéntale tu caso a nuestro equipo.
