Nouer une relation de structure

POST

/vehicules/{vehicule}/relations

curl --request POST \
  --url https://example.com/vehicules/example/relations \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{ "type": "maitre_nourricier", "du": "2026-04-15", "maitre": { "nom": "example", "isin": "example" }, "titre": { "emetteur": "example", "isin": "example" }, "role_du_titre": "sous_jacent_principal", "mode_exposition": "direct", "provenance": { "source": "document", "document": "example" } }'

Au plus une relation maître effective par nourricier ; un changement de maître termine la relation et en ouvre une nouvelle. Le maître et le titre visé sont des références publiées, jamais des lignes du référentiel.

Autorisations

• authentification
  instruments:administration

Paramètres

Paramètres (path)

vehicule

required

string

>= 1 characters

Corps de la requête^required

Media typeapplication/json

object

type

required

string

Allowed values: maitre_nourricier sous_jacent

du

required

string format: date

maitre

La cible d’une relation maître/nourricier.

object

nom

string

isin

string

titre

Le titre visé d’une relation sous-jacent.

object

emetteur

string

isin

string

role_du_titre

string

Allowed values: sous_jacent_principal sous_jacent_de_formule titre_de_reference actif_de_couverture

mode_exposition

string

Allowed values: direct indirect garanti a_effet_de_levier

provenance

required

object

source

required

string

Allowed values: document saisie flux_de_place

document

La référence du document versé — obligatoire quand la source est un document.

string

Réponses

202

La demande de validation est créée — l’effet attend sa validation par un valideur distinct du préparateur.

Media typeapplication/json

object

demande

required

string

objet

required

string

Allowed values: referencement transition_de_cycle caracteristique restriction regle_de_valorisation relation role_d_intervenant version_de_calendrier exception_de_calendrier intervenant

cible

string

Example

{
  "objet": "referencement"
}

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:administration.

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"
}