Tenir le cycle d'une occurrence

POST

/occurrences/{occurrence}/transitions

curl --request POST \
  --url https://example.com/occurrences/example/transitions \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "geste": "confirmer", "motif": "example", "date_de_remplacement": "2026-04-15", "source": "example" }'

Le report est un terminus : l’occurrence de remplacement naît du même geste — jamais de modification en place. Toute transition est motivée quand elle ferme ou suspend, et publie son fait.

Autorisations

• authentification
  instruments:publication

Paramètres

Paramètres (path)

occurrence

required

string

>= 1 characters

Corps de la requête^required

Media typeapplication/json

object

geste

required

string

Allowed values: confirmer reporter annuler suspendre reprendre

motif

Obligatoire pour reporter

string

date_de_remplacement

Obligatoire pour un report — la date de l’occurrence de remplacement.

string format: date

source

La source de la décision (suspension notifiée

string

Réponses

201

La transition est appliquée, son fait est retenu — pour un report, l’occurrence de remplacement est servie.

Media typeapplication/json

object

occurrence

required

string

statut

required

string

Allowed values: prevue confirmee reportee annulee suspendue

occurrence_remplacante

string

Example

{
  "statut": "prevue"
}

400

La demande est irrecevable (champ manquant, date mal formée, flottant…) — le motif nomme le champ.

Media typeapplication/json

object

motif

required

Le motif

string

Example^generated

{
  "motif": "example"
}

401

Aucune identité présentée.

403

L’identité présentée n’a pas la famille d’accès instruments:publication.

404

La ressource est inconnue de ce tenant — rien n’existe à travers la muraille.

Media typeapplication/json

object

motif

required

Le motif

string

Example^generated

{
  "motif": "example"
}

422

Le domaine refuse (invariant violé : chevauchement de périodes, inapplicable à la nature, cycle qui n’admet pas la transition, rang déjà publié, préparateur valideur…) — rien n’est retenu, aucun fait n’existe ; le motif nomme l’invariant.

Media typeapplication/json

object

motif

required

Le motif

string

Example^generated

{
  "motif": "example"
}