Lister les priorités avec l'API PagerDuty
Liste les priorités d'incident du compte, de la plus à la moins grave, comme P1 à P5. L'id va dans le priority de Create incident et Update incident. Un compte qui n'a pas configuré de priorités n'en a aucune.
- Identifiant
- pagerduty_list_priorities
L'appel
POST https://connect.reportei.com/api/tools/pagerduty_list_priorities/execute
Authorization: Bearer <merchant token>
x-customer-token: <customer token>
Content-Type: application/json
Accept: application/json
{
"customer_toolkit": "<connection UUID>",
"arguments": {
"limit": 1
}
}Votre système envoie l'id de la connexion de votre client et les arguments de la tool. Les headers sont les mêmes que pour toute l'API Connect : le token de votre produit et celui de votre client.
Paramètres
Les descriptions des paramètres suivent la documentation officielle de l'app, en anglais.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| limit | integer | Non | Priorities per page, up to 100. |
| offset | integer | Non | Number of priorities to skip. |
| total | boolean | Non | Set to true to fill the total field of the response, which is slower. |
Connexions possibles
Votre client connecte son compte PagerDuty une seule fois, avec l'un des modes ci-dessous. La même connexion sert à toutes les tools du toolkit.
Clé d'API
Votre client colle la clé de l'app sur un écran de Connect, ou votre système envoie la clé avec POST /api/customer-toolkits, sans écran.
La réponse
En cas de succès, Connect conserve le statut et le corps de la réponse de l'app. Les erreurs HTTP renvoyées par l'app utilisent l'objet {error, api_error} ; l'authentification ou la validation peuvent échouer avant l'exécution. Le header X-Toolkit-Execution-Id identifie l'exécution enregistrée, consultable avec GET /api/tools/executions/{uuid}.
Prête pour les agents IA
L'input de cette tool est un JSON Schema, disponible via GET /api/tools/pagerduty_list_priorities. Il devient la définition de tool de votre agent sans conversion.
Autres tools PagerDuty
- Lister les incidentsGETListe les incidents du compte créés le mois dernier, ou dans la plage de since et until. Il n'y a pas de filtre par statut, service ou assigné ici, lisez donc status, service et assignments dans chaque élément. Paginez avec limit et offset tant que more est true.
- Obtenir un incidentGETRenvoie un incident avec son statut, son urgence, sa priorité, son service, ses assignations, ses prises en compte et sa politique d'escalade.
- Créer un incidentPOSTCrée un incident sur un service, ce qui notifie la politique d'escalade du service, ou les utilisateurs dans assignments. Nécessite type, title et service. Envoyez assignments ou escalation_policy, jamais les deux. Un incident que l'utilisateur s'assigne à lui-même démarre pris en compte, sans le notifier.
- Mettre à jour un incidentPUTPrend en compte, résout, réassigne ou escalade un incident, ou change son titre, son urgence, sa priorité ou son service. Envoyez type et seulement les champs à modifier. Réassigner ou escalader notifie les nouveaux responsables, et définir status sur un incident résolu le rouvre.
- Lister les notes d'un incidentGETListe les notes d'un incident, chacune avec son contenu, son auteur et son heure de création.
- Créer une note sur un incidentPOSTAjoute une note à un incident, signée par l'utilisateur de la connexion. Un incident peut contenir jusqu'à 2000 notes.
- Lister les entrées de journal d'un incidentGETListe la chronologie d'un incident : déclenchements, notifications, prises en compte, assignations, escalades, notes et résolution, chacun avec l'agent et l'heure. Paginez avec limit et offset tant que more est true.
- Lister les servicesGETListe les services du compte, chacun avec id, nom, statut et politique d'escalade. L'id est ce que demandent Create incident et Update incident. Paginez avec limit et offset tant que more est true.
Toolkits de la même catégorie
Voir les 100 toolkitsVoyez Connect appliqué à votre produit.
Essayez-le pendant 15 jours sans carte, ou présentez votre cas à notre équipe.
