Aller au contenu principal

Risques

Registre des risques : création, traitement, liens, clôture, matrice.

GET /api/v1/entities/{entityId}/risks POST /api/v1/entities/{entityId}/risks GET /api/v1/entities/{entityId}/risks/{riskId} PATCH /api/v1/entities/{entityId}/risks/{riskId} DELETE /api/v1/entities/{entityId}/risks/{riskId} GET /api/v1/entities/{entityId}/risks/{riskId}/links POST /api/v1/entities/{entityId}/risks/{riskId}/links DELETE /api/v1/entities/{entityId}/risks/{riskId}/links/{linkId} GET /api/v1/entities/{entityId}/risks/{riskId}/reviews POST /api/v1/entities/{entityId}/risks/{riskId}/reviews GET /api/v1/entities/{entityId}/risks/{riskId}/treatment-actions POST /api/v1/entities/{entityId}/risks/{riskId}/treatment-actions PATCH /api/v1/entities/{entityId}/risks/{riskId}/treatment-actions/{actionId} DELETE /api/v1/entities/{entityId}/risks/{riskId}/treatment-actions/{actionId} GET /api/v1/entities/{entityId}/risks/matrix

GET /api/v1/entities/{entityId}/risks

Accès
Permission risques : lecture (Risks.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) —
Methodology requête string max. 100 caractères
Category requête string max. 100 caractères
Status requête string max. 100 caractères
OwnerUserId requête string (uuid) —
Criticality requête string max. 100 caractères
ReviewDueBefore requête string (date) —
Likelihood requête integer (int16) —
Impact requête integer (int16) —
EbiosStudyId requête string (uuid) —
Page requête integer ≥ 1
PageSize requête integer ≥ 1 · ≤ 100

Réponse 200 · application/json

Schéma RiskListResponse

Champ Type Contraintes
data RiskListItemResponse[] —
meta PaginationMeta —

POST /api/v1/entities/{entityId}/risks

Accès
Permission risques : écriture (Risks.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 CreateRiskRequest

Champ Type Contraintes
title requis string max. 500 caractères
description string | null max. 2000 caractères
methodology requis string max. 100 caractères
category string | null max. 100 caractères
likelihood integer (int16) | null —
impact integer (int16) | null —
confidentialityImpact integer (int16) | null —
integrityImpact integer (int16) | null —
availabilityImpact integer (int16) | null —
treatmentType string | null max. 100 caractères
ownerUserId string (uuid) | null —
reviewDate string (date) | null —

Réponse 200 · application/json

Schéma RiskResponse

Champ Type Contraintes
id string (uuid) —
code string —
title string —
description string | null —
methodology string —
category string | null —
status string —
likelihood integer (int16) | null —
impact integer (int16) | null —
inherentScore number | null —
residualScore number | null —
inherentCriticality string | null —
residualCriticality string | null —
confidentialityImpact integer (int16) | null —
integrityImpact integer (int16) | null —
availabilityImpact integer (int16) | null —
residualLikelihood integer (int16) | null —
residualImpact integer (int16) | null —
treatmentType string | null —
treatmentJustification string | null —
treatmentActionsTotal integer —
treatmentActionsCompleted integer —
treatmentProgress number —
ownerUserId string (uuid) | null —
ownerName string | null —
reviewDate string (date) | null —
isReviewDue boolean —
ebiosSource string | null —
ebiosTarget string | null —
ebiosStudyId string (uuid) | null —
closedAt string (date-time) | null —
closedJustification string | null —
createdAt string (date-time) —
updatedAt string (date-time) —
linksCount integer —
reviewsCount integer —

GET /api/v1/entities/{entityId}/risks/{riskId}

Accès
Permission risques : lecture (Risks.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) —
riskId requis chemin string (uuid) —

Réponse 200 · application/json

Schéma RiskResponse

Champ Type Contraintes
id string (uuid) —
code string —
title string —
description string | null —
methodology string —
category string | null —
status string —
likelihood integer (int16) | null —
impact integer (int16) | null —
inherentScore number | null —
residualScore number | null —
inherentCriticality string | null —
residualCriticality string | null —
confidentialityImpact integer (int16) | null —
integrityImpact integer (int16) | null —
availabilityImpact integer (int16) | null —
residualLikelihood integer (int16) | null —
residualImpact integer (int16) | null —
treatmentType string | null —
treatmentJustification string | null —
treatmentActionsTotal integer —
treatmentActionsCompleted integer —
treatmentProgress number —
ownerUserId string (uuid) | null —
ownerName string | null —
reviewDate string (date) | null —
isReviewDue boolean —
ebiosSource string | null —
ebiosTarget string | null —
ebiosStudyId string (uuid) | null —
closedAt string (date-time) | null —
closedJustification string | null —
createdAt string (date-time) —
updatedAt string (date-time) —
linksCount integer —
reviewsCount integer —

PATCH /api/v1/entities/{entityId}/risks/{riskId}

Accès
Permission risques : écriture (Risks.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) —
riskId requis chemin string (uuid) —

Corps de la requête application/json, requis

Schéma UpdateRiskRequest

Champ Type Contraintes
title string | null max. 500 caractères
description string | null max. 2000 caractères
category string | null max. 100 caractères
status string | null max. 100 caractères
likelihood integer (int16) | null —
impact integer (int16) | null —
confidentialityImpact integer (int16) | null —
integrityImpact integer (int16) | null —
availabilityImpact integer (int16) | null —
residualScore number | null —
residualLikelihood integer (int16) | null —
residualImpact integer (int16) | null —
treatmentType string | null max. 100 caractères
treatmentJustification string | null max. 2000 caractères
ownerUserId string (uuid) | null —
reviewDate string (date) | null —

Réponse 200 · application/json

Schéma RiskResponse

Champ Type Contraintes
id string (uuid) —
code string —
title string —
description string | null —
methodology string —
category string | null —
status string —
likelihood integer (int16) | null —
impact integer (int16) | null —
inherentScore number | null —
residualScore number | null —
inherentCriticality string | null —
residualCriticality string | null —
confidentialityImpact integer (int16) | null —
integrityImpact integer (int16) | null —
availabilityImpact integer (int16) | null —
residualLikelihood integer (int16) | null —
residualImpact integer (int16) | null —
treatmentType string | null —
treatmentJustification string | null —
treatmentActionsTotal integer —
treatmentActionsCompleted integer —
treatmentProgress number —
ownerUserId string (uuid) | null —
ownerName string | null —
reviewDate string (date) | null —
isReviewDue boolean —
ebiosSource string | null —
ebiosTarget string | null —
ebiosStudyId string (uuid) | null —
closedAt string (date-time) | null —
closedJustification string | null —
createdAt string (date-time) —
updatedAt string (date-time) —
linksCount integer —
reviewsCount integer —

DELETE /api/v1/entities/{entityId}/risks/{riskId}

Accès
Permission risques : écriture (Risks.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) —
riskId requis chemin string (uuid) —

Corps de la requête application/json, requis

Schéma CloseRiskRequest

Champ Type Contraintes
justification requis string max. 2000 caractères

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}/risks/{riskId}/links

Accès
Permission risques : écriture (Risks.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) —
riskId requis chemin string (uuid) —

Corps de la requête application/json, requis

Schéma CreateRiskLinkRequest

Champ Type Contraintes
linkedType requis string max. 100 caractères
linkedId requis string (uuid) —

Réponse 200 · application/json

Schéma RiskLinkResponse

Champ Type Contraintes
id string (uuid) —
riskId string (uuid) —
linkedType string —
linkedId string (uuid) —
linkedLabel string | null —

GET /api/v1/entities/{entityId}/risks/{riskId}/reviews

Accès
Permission risques : lecture (Risks.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) —
riskId requis chemin string (uuid) —

Réponse 200 · application/json

Type RiskReviewResponse[]

POST /api/v1/entities/{entityId}/risks/{riskId}/reviews

Accès
Permission risques : écriture (Risks.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) —
riskId requis chemin string (uuid) —

Corps de la requête application/json, requis

Schéma CreateReviewRequest

Champ Type Contraintes
newLikelihood integer (int16) | null —
newImpact integer (int16) | null —
newConfidentialityImpact integer (int16) | null —
newIntegrityImpact integer (int16) | null —
newAvailabilityImpact integer (int16) | null —
comment string | null max. 2000 caractères
nextReviewDate string (date) | null —

Réponse 200 · application/json

Schéma RiskReviewResponse

Champ Type Contraintes
id string (uuid) —
riskId string (uuid) —
reviewedByUserId string (uuid) —
reviewedByName string —
previousLikelihood integer (int16) | null —
previousImpact integer (int16) | null —
previousInherentScore number | null —
previousResidualScore number | null —
newLikelihood integer (int16) | null —
newImpact integer (int16) | null —
newInherentScore number | null —
newResidualScore number | null —
comment string | null —
reviewedAt string (date-time) —

GET /api/v1/entities/{entityId}/risks/{riskId}/treatment-actions

Accès
Permission risques : lecture (Risks.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) —
riskId requis chemin string (uuid) —

Réponse 200 · application/json

Type TreatmentActionResponse[]

POST /api/v1/entities/{entityId}/risks/{riskId}/treatment-actions

Accès
Permission risques : écriture (Risks.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) —
riskId requis chemin string (uuid) —

Corps de la requête application/json, requis

Schéma CreateTreatmentActionRequest

Champ Type Contraintes
action requis string max. 2000 caractères
ownerUserId string (uuid) | null —
dueDate string (date) | null —
linkedControlId string (uuid) | null —

Réponse 200 · application/json

Schéma TreatmentActionResponse

Champ Type Contraintes
id string (uuid) —
riskId string (uuid) —
action string —
ownerUserId string (uuid) | null —
ownerName string | null —
dueDate string (date) | null —
status string —
linkedControlId string (uuid) | null —
linkedControlCode string | null —
completedAt string (date-time) | null —
createdAt string (date-time) —
updatedAt string (date-time) —

PATCH /api/v1/entities/{entityId}/risks/{riskId}/treatment-actions/{actionId}

Accès
Permission risques : écriture (Risks.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) —
riskId requis chemin string (uuid) —
actionId requis chemin string (uuid) —

Corps de la requête application/json, requis

Schéma UpdateTreatmentActionRequest

Champ Type Contraintes
action string | null max. 2000 caractères
ownerUserId string (uuid) | null —
dueDate string (date) | null —
status string | null max. 100 caractères
linkedControlId string (uuid) | null —

Réponse 200 · application/json

Schéma TreatmentActionResponse

Champ Type Contraintes
id string (uuid) —
riskId string (uuid) —
action string —
ownerUserId string (uuid) | null —
ownerName string | null —
dueDate string (date) | null —
status string —
linkedControlId string (uuid) | null —
linkedControlCode string | null —
completedAt string (date-time) | null —
createdAt string (date-time) —
updatedAt string (date-time) —

DELETE /api/v1/entities/{entityId}/risks/{riskId}/treatment-actions/{actionId}

Accès
Permission risques : écriture (Risks.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) —
riskId requis chemin string (uuid) —
actionId 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}/risks/matrix

Accès
Permission risques : lecture (Risks.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) —
methodology requête string —
residual requête boolean défaut : false

Réponse 200 · application/json

Schéma RiskMatrixResponse

Champ Type Contraintes
cells RiskMatrixCell[] —
kpis RiskKpis —
matrixSize integer —

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.

RiskListResponse

Champ Type Contraintes
data RiskListItemResponse[] —
meta PaginationMeta —

RiskListItemResponse

Champ Type Contraintes
id string (uuid) —
code string —
title string —
methodology string —
category string | null —
status string —
likelihood integer (int16) | null —
impact integer (int16) | null —
inherentScore number | null —
residualScore number | null —
inherentCriticality string | null —
residualCriticality string | null —
treatmentType string | null —
ownerUserId string (uuid) | null —
ownerName string | null —
reviewDate string (date) | null —
isReviewDue boolean —
treatmentProgress number —

PaginationMeta

Champ Type Contraintes
total integer —
page integer —
pageSize integer —

CreateRiskRequest

Champ Type Contraintes
title requis string max. 500 caractères
description string | null max. 2000 caractères
methodology requis string max. 100 caractères
category string | null max. 100 caractères
likelihood integer (int16) | null —
impact integer (int16) | null —
confidentialityImpact integer (int16) | null —
integrityImpact integer (int16) | null —
availabilityImpact integer (int16) | null —
treatmentType string | null max. 100 caractères
ownerUserId string (uuid) | null —
reviewDate string (date) | null —

RiskResponse

Champ Type Contraintes
id string (uuid) —
code string —
title string —
description string | null —
methodology string —
category string | null —
status string —
likelihood integer (int16) | null —
impact integer (int16) | null —
inherentScore number | null —
residualScore number | null —
inherentCriticality string | null —
residualCriticality string | null —
confidentialityImpact integer (int16) | null —
integrityImpact integer (int16) | null —
availabilityImpact integer (int16) | null —
residualLikelihood integer (int16) | null —
residualImpact integer (int16) | null —
treatmentType string | null —
treatmentJustification string | null —
treatmentActionsTotal integer —
treatmentActionsCompleted integer —
treatmentProgress number —
ownerUserId string (uuid) | null —
ownerName string | null —
reviewDate string (date) | null —
isReviewDue boolean —
ebiosSource string | null —
ebiosTarget string | null —
ebiosStudyId string (uuid) | null —
closedAt string (date-time) | null —
closedJustification string | null —
createdAt string (date-time) —
updatedAt string (date-time) —
linksCount integer —
reviewsCount integer —

UpdateRiskRequest

Champ Type Contraintes
title string | null max. 500 caractères
description string | null max. 2000 caractères
category string | null max. 100 caractères
status string | null max. 100 caractères
likelihood integer (int16) | null —
impact integer (int16) | null —
confidentialityImpact integer (int16) | null —
integrityImpact integer (int16) | null —
availabilityImpact integer (int16) | null —
residualScore number | null —
residualLikelihood integer (int16) | null —
residualImpact integer (int16) | null —
treatmentType string | null max. 100 caractères
treatmentJustification string | null max. 2000 caractères
ownerUserId string (uuid) | null —
reviewDate string (date) | null —

CloseRiskRequest

Champ Type Contraintes
justification requis string max. 2000 caractères

RiskLinkResponse

Champ Type Contraintes
id string (uuid) —
riskId string (uuid) —
linkedType string —
linkedId string (uuid) —
linkedLabel string | null —

CreateRiskLinkRequest

Champ Type Contraintes
linkedType requis string max. 100 caractères
linkedId requis string (uuid) —

RiskReviewResponse

Champ Type Contraintes
id string (uuid) —
riskId string (uuid) —
reviewedByUserId string (uuid) —
reviewedByName string —
previousLikelihood integer (int16) | null —
previousImpact integer (int16) | null —
previousInherentScore number | null —
previousResidualScore number | null —
newLikelihood integer (int16) | null —
newImpact integer (int16) | null —
newInherentScore number | null —
newResidualScore number | null —
comment string | null —
reviewedAt string (date-time) —

CreateReviewRequest

Champ Type Contraintes
newLikelihood integer (int16) | null —
newImpact integer (int16) | null —
newConfidentialityImpact integer (int16) | null —
newIntegrityImpact integer (int16) | null —
newAvailabilityImpact integer (int16) | null —
comment string | null max. 2000 caractères
nextReviewDate string (date) | null —

TreatmentActionResponse

Champ Type Contraintes
id string (uuid) —
riskId string (uuid) —
action string —
ownerUserId string (uuid) | null —
ownerName string | null —
dueDate string (date) | null —
status string —
linkedControlId string (uuid) | null —
linkedControlCode string | null —
completedAt string (date-time) | null —
createdAt string (date-time) —
updatedAt string (date-time) —

CreateTreatmentActionRequest

Champ Type Contraintes
action requis string max. 2000 caractères
ownerUserId string (uuid) | null —
dueDate string (date) | null —
linkedControlId string (uuid) | null —

UpdateTreatmentActionRequest

Champ Type Contraintes
action string | null max. 2000 caractères
ownerUserId string (uuid) | null —
dueDate string (date) | null —
status string | null max. 100 caractères
linkedControlId string (uuid) | null —

RiskMatrixResponse

Champ Type Contraintes
cells RiskMatrixCell[] —
kpis RiskKpis —
matrixSize integer —

RiskMatrixCell

Champ Type Contraintes
likelihood requis integer —
impact requis integer —
count requis integer —
criticalityLabel requis string —

RiskKpis

Champ Type Contraintes
total integer —
critical integer —
high integer —
reviewDue integer —

Mise à jour : 10 octobre 2026. Signaler une inexactitude