Incidents
Incidents de sécurité : déclaration, statuts, notifications NIS2, retour d’expérience.
GET
/api/v1/entities/{entityId}/incidents POST /api/v1/entities/{entityId}/incidents GET /api/v1/entities/{entityId}/incidents/{incidentId} PATCH /api/v1/entities/{entityId}/incidents/{incidentId} GET /api/v1/entities/{entityId}/incidents/{incidentId}/checklist POST /api/v1/entities/{entityId}/incidents/{incidentId}/checklist PATCH /api/v1/entities/{entityId}/incidents/{incidentId}/checklist/{itemId} DELETE /api/v1/entities/{entityId}/incidents/{incidentId}/checklist/{itemId} POST /api/v1/entities/{entityId}/incidents/{incidentId}/close GET /api/v1/entities/{entityId}/incidents/{incidentId}/journal POST /api/v1/entities/{entityId}/incidents/{incidentId}/journal GET /api/v1/entities/{entityId}/incidents/{incidentId}/links POST /api/v1/entities/{entityId}/incidents/{incidentId}/links DELETE /api/v1/entities/{entityId}/incidents/{incidentId}/links/{linkId} GET /api/v1/entities/{entityId}/incidents/{incidentId}/notifications PUT /api/v1/entities/{entityId}/incidents/{incidentId}/notifications POST /api/v1/entities/{entityId}/incidents/{incidentId}/notifications/submit PUT /api/v1/entities/{entityId}/incidents/{incidentId}/retex POST /api/v1/entities/{entityId}/incidents/{incidentId}/transition GET /api/v1/entities/{entityId}/incidents/metrics GET /api/v1/entities/{entityId}/incidents
- Accès
-
Permission incidents : lecture
(Incidents.Read), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- aucune (les lectures ne sont pas limitées)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
Severity | requête | IncidentSeverity | — |
Status | requête | IncidentStatus | — |
OwnerUserId | requête | string (uuid) | — |
RegulatoryNotificationRequired | requête | boolean | — |
Q | requête | string | — |
Page | requête | integer | — |
PageSize | requête | integer | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
POST /api/v1/entities/{entityId}/incidents
- Accès
-
Permission incidents : écriture
(Incidents.Write), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- 60 requêtes d’écriture par minute et par utilisateur (budget partagé entre tous les points d’accès concernés ; GET non comptés)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
Corps de la requête
application/json, requis
Schéma CreateIncidentRequest
| Champ | Type | Contraintes |
|---|---|---|
title requis | string | — |
description requis | string | null | — |
severity requis | IncidentSeverity | — |
detectionAt requis | string (date-time) | — |
ownerUserId requis | string (uuid) | null | — |
regulatoryNotificationRequired | boolean | défaut : false |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
GET /api/v1/entities/{entityId}/incidents/{incidentId}
- Accès
-
Permission incidents : lecture
(Incidents.Read), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- aucune (les lectures ne sont pas limitées)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
incidentId requis | chemin | string (uuid) | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
PATCH /api/v1/entities/{entityId}/incidents/{incidentId}
- Accès
-
Permission incidents : écriture
(Incidents.Write), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- 60 requêtes d’écriture par minute et par utilisateur (budget partagé entre tous les points d’accès concernés ; GET non comptés)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
incidentId requis | chemin | string (uuid) | — |
Corps de la requête
application/json, requis
Schéma UpdateIncidentRequest
| Champ | Type | Contraintes |
|---|---|---|
title requis | string | null | — |
description requis | string | null | — |
severity requis | IncidentSeverity | null | — |
ownerUserId requis | string (uuid) | null | — |
regulatoryNotificationRequired requis | boolean | null | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
GET /api/v1/entities/{entityId}/incidents/{incidentId}/checklist
- Accès
-
Permission incidents : lecture
(Incidents.Read), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- aucune (les lectures ne sont pas limitées)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
incidentId requis | chemin | string (uuid) | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
POST /api/v1/entities/{entityId}/incidents/{incidentId}/checklist
- Accès
-
Permission incidents : écriture
(Incidents.Write), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- 60 requêtes d’écriture par minute et par utilisateur (budget partagé entre tous les points d’accès concernés ; GET non comptés)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
incidentId requis | chemin | string (uuid) | — |
Corps de la requête
application/json, requis
Schéma CreateChecklistItemRequest
| Champ | Type | Contraintes |
|---|---|---|
title requis | string | — |
order | integer | défaut : 0 |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
PATCH /api/v1/entities/{entityId}/incidents/{incidentId}/checklist/{itemId}
- Accès
-
Permission incidents : écriture
(Incidents.Write), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- 60 requêtes d’écriture par minute et par utilisateur (budget partagé entre tous les points d’accès concernés ; GET non comptés)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
incidentId requis | chemin | string (uuid) | — |
itemId requis | chemin | string (uuid) | — |
Corps de la requête
application/json, requis
Schéma ToggleChecklistItemRequest
| Champ | Type | Contraintes |
|---|---|---|
isCompleted requis | boolean | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
DELETE /api/v1/entities/{entityId}/incidents/{incidentId}/checklist/{itemId}
- Accès
-
Permission incidents : écriture
(Incidents.Write), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- 60 requêtes d’écriture par minute et par utilisateur (budget partagé entre tous les points d’accès concernés ; GET non comptés)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
incidentId requis | chemin | string (uuid) | — |
itemId requis | chemin | string (uuid) | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
POST /api/v1/entities/{entityId}/incidents/{incidentId}/close
- Accès
-
Permission incidents : écriture
(Incidents.Write), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- 60 requêtes d’écriture par minute et par utilisateur (budget partagé entre tous les points d’accès concernés ; GET non comptés)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
incidentId requis | chemin | string (uuid) | — |
Corps de la requête
application/json, requis
Schéma CloseIncidentRequest
| Champ | Type | Contraintes |
|---|---|---|
rootCause requis | string | — |
lessonsLearned requis | string | — |
comment requis | string | null | — |
closedAt | string (date-time) | null | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
GET /api/v1/entities/{entityId}/incidents/{incidentId}/journal
- Accès
-
Permission incidents : lecture
(Incidents.Read), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- aucune (les lectures ne sont pas limitées)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
incidentId requis | chemin | string (uuid) | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
POST /api/v1/entities/{entityId}/incidents/{incidentId}/journal
- Accès
-
Permission incidents : écriture
(Incidents.Write), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- 60 requêtes d’écriture par minute et par utilisateur (budget partagé entre tous les points d’accès concernés ; GET non comptés)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
incidentId requis | chemin | string (uuid) | — |
Corps de la requête
application/json, requis
Schéma AddJournalEntryRequest
| Champ | Type | Contraintes |
|---|---|---|
content requis | string | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
GET /api/v1/entities/{entityId}/incidents/{incidentId}/links
- Accès
-
Permission incidents : lecture
(Incidents.Read), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- aucune (les lectures ne sont pas limitées)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
incidentId requis | chemin | string (uuid) | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
POST /api/v1/entities/{entityId}/incidents/{incidentId}/links
- Accès
-
Permission incidents : écriture
(Incidents.Write), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- 60 requêtes d’écriture par minute et par utilisateur (budget partagé entre tous les points d’accès concernés ; GET non comptés)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
incidentId requis | chemin | string (uuid) | — |
Corps de la requête
application/json, requis
Schéma CreateIncidentLinkRequest
| Champ | Type | Contraintes |
|---|---|---|
linkedType requis | IncidentLinkType | — |
linkedId requis | string (uuid) | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
DELETE /api/v1/entities/{entityId}/incidents/{incidentId}/links/{linkId}
- Accès
-
Permission incidents : écriture
(Incidents.Write), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- 60 requêtes d’écriture par minute et par utilisateur (budget partagé entre tous les points d’accès concernés ; GET non comptés)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
incidentId requis | chemin | string (uuid) | — |
linkId requis | chemin | string (uuid) | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
GET /api/v1/entities/{entityId}/incidents/{incidentId}/notifications
- Accès
-
Permission incidents : lecture
(Incidents.Read), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- aucune (les lectures ne sont pas limitées)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
incidentId requis | chemin | string (uuid) | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
PUT /api/v1/entities/{entityId}/incidents/{incidentId}/notifications
- Accès
-
Permission incidents : écriture
(Incidents.Write), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- 60 requêtes d’écriture par minute et par utilisateur (budget partagé entre tous les points d’accès concernés ; GET non comptés)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
incidentId requis | chemin | string (uuid) | — |
Corps de la requête
application/json, requis
Schéma SaveNotificationRequest
| Champ | Type | Contraintes |
|---|---|---|
notificationType requis | IncidentNotificationType | — |
contentJson requis | string | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
POST /api/v1/entities/{entityId}/incidents/{incidentId}/notifications/submit
- Accès
-
Permission incidents : écriture
(Incidents.Write), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- 60 requêtes d’écriture par minute et par utilisateur (budget partagé entre tous les points d’accès concernés ; GET non comptés)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
incidentId requis | chemin | string (uuid) | — |
Corps de la requête
application/json, requis
Schéma SubmitNotificationRequest
| Champ | Type | Contraintes |
|---|---|---|
notificationType requis | IncidentNotificationType | — |
referenceNumber requis | string | null | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
PUT /api/v1/entities/{entityId}/incidents/{incidentId}/retex
- Accès
-
Permission incidents : écriture
(Incidents.Write), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- 60 requêtes d’écriture par minute et par utilisateur (budget partagé entre tous les points d’accès concernés ; GET non comptés)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
incidentId requis | chemin | string (uuid) | — |
Corps de la requête
application/json, requis
Schéma UpdateRetexRequest
| Champ | Type | Contraintes |
|---|---|---|
rootCause requis | string | — |
lessonsLearned requis | string | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
POST /api/v1/entities/{entityId}/incidents/{incidentId}/transition
- Accès
-
Permission incidents : écriture
(Incidents.Write), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- 60 requêtes d’écriture par minute et par utilisateur (budget partagé entre tous les points d’accès concernés ; GET non comptés)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
incidentId requis | chemin | string (uuid) | — |
Corps de la requête
application/json, requis
Schéma TransitionStatusRequest
| Champ | Type | Contraintes |
|---|---|---|
newStatus requis | IncidentStatus | — |
comment requis | string | null | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
GET /api/v1/entities/{entityId}/incidents/metrics
- Accès
-
Permission incidents : lecture
(Incidents.Read), accordée par le rôle de l’utilisateur sur l’entité du chemin. - Limite de débit
- aucune (les lectures ne sont pas limitées)
Paramètres
| Nom | Où | Type | Contraintes |
|---|---|---|---|
entityId requis | chemin | string (uuid) | — |
Réponse 200
Réponse non décrite dans le document OpenAPI (le code de l’action ne déclare pas son type de retour).
Schémas
Objets utilisés par les opérations de cette page. Les nombres sont écrits en JSON comme des nombres ; les énumérations, comme des chaînes.
IncidentSeverity
Énumération (chaîne) : P1, P2, P3, P4
IncidentStatus
Énumération (chaîne) : Detected, Triaged, Responding, Resolved, Closed, Reported
CreateIncidentRequest
| Champ | Type | Contraintes |
|---|---|---|
title requis | string | — |
description requis | string | null | — |
severity requis | IncidentSeverity | — |
detectionAt requis | string (date-time) | — |
ownerUserId requis | string (uuid) | null | — |
regulatoryNotificationRequired | boolean | défaut : false |
UpdateIncidentRequest
| Champ | Type | Contraintes |
|---|---|---|
title requis | string | null | — |
description requis | string | null | — |
severity requis | IncidentSeverity | null | — |
ownerUserId requis | string (uuid) | null | — |
regulatoryNotificationRequired requis | boolean | null | — |
CreateChecklistItemRequest
| Champ | Type | Contraintes |
|---|---|---|
title requis | string | — |
order | integer | défaut : 0 |
ToggleChecklistItemRequest
| Champ | Type | Contraintes |
|---|---|---|
isCompleted requis | boolean | — |
CloseIncidentRequest
| Champ | Type | Contraintes |
|---|---|---|
rootCause requis | string | — |
lessonsLearned requis | string | — |
comment requis | string | null | — |
closedAt | string (date-time) | null | — |
AddJournalEntryRequest
| Champ | Type | Contraintes |
|---|---|---|
content requis | string | — |
CreateIncidentLinkRequest
| Champ | Type | Contraintes |
|---|---|---|
linkedType requis | IncidentLinkType | — |
linkedId requis | string (uuid) | — |
IncidentLinkType
Énumération (chaîne) : Asset, Control, Supplier, DataBreach
SaveNotificationRequest
| Champ | Type | Contraintes |
|---|---|---|
notificationType requis | IncidentNotificationType | — |
contentJson requis | string | — |
IncidentNotificationType
Énumération (chaîne) : Initial24h, Intermediate72h, Final30d
SubmitNotificationRequest
| Champ | Type | Contraintes |
|---|---|---|
notificationType requis | IncidentNotificationType | — |
referenceNumber requis | string | null | — |
UpdateRetexRequest
| Champ | Type | Contraintes |
|---|---|---|
rootCause requis | string | — |
lessonsLearned requis | string | — |
TransitionStatusRequest
| Champ | Type | Contraintes |
|---|---|---|
newStatus requis | IncidentStatus | — |
comment requis | string | null | — |
Mise à jour : 10 octobre 2026. Signaler une inexactitude