Skip to main content
Creer le metadata d'un document

Authorizations

Authorization
string
header
required

Use the access_token returned by POST /v1/auth/token. Do not send the raw API secret on business endpoints.

Headers

X-Request-ID
string

Partner-generated correlation identifier echoed in logs and error payloads.

Idempotency-Key
string
required

Required for every write, including environments where replay deduplication is disabled. Reuse the same value when retrying the same logical write and use a new value for a different write.

Maximum string length: 255
Pattern: ^[!-~]+$

Path Parameters

external_id
string
required

Identifiant stable de votre système, dans le contexte de votre intégration.

Required string length: 1 - 255
Pattern: ^[A-Za-z0-9_~-][A-Za-z0-9._:~-]{0,254}$

Body

application/json

Une opération est requise: fournir operation_id ou operation_external_id. Lorsque les deux sont fournis, operation_id est utilisé. Pour un upload de fichier, appeler directement /upload avec un nouvel external_id; une déclaration metadata préalable peut être renvoyée sans ajout de fichier.

operation_id
string<uuid>
required

UUID MARKO de l'opération.

type
string
required

Catégorie métier du document, distincte de son type MIME; par exemple autre pour un document non spécialisé.

Required string length: 1 - 100
operation_external_id
string | null

Identifiant externe de l'opération, appartenant à la même intégration.

filename
string | null

Nom du fichier.

Maximum string length: 255
partner_metadata
Partner Metadata · object

Objet JSON extensible. Les types des valeurs sont indiqués par additionalProperties lorsque la route les contraint.

Response

Référence documentaire existante ou réponse rejouée.

external_id
string
required

Identifiant stable de votre système, dans le contexte de votre intégration.

document_id
string<uuid>
required

UUID MARKO du document.

created
boolean
required

Indique si une nouvelle fiche documentaire a été créée par cet appel.

document
PublicDocumentItem · object
required

Fiche du document associée à l'identifiant externe.