Creer ou mettre a jour une operation externe

Crée ou met à jour immédiatement une opération à partir d’un identifiant partenaire stable. La réponse contient directement marko_id. Une valeur de taxonomie inconnue est créée pour l’entité, visible immédiatement et signalée dans taxonomy_additions. Le segment généré des codes custom__... n’est pas prévisible : le client doit conserver le code renvoyé et le réutiliser. Une création répond 201; une mise à jour, restauration ou répétition sans changement répond 200. Les notes utilisent leur endpoint dédié; seul POST /operations/batch reste asynchrone.

Scope requis : operations:write. Scopes et délégation.

Idempotence : header Idempotency-Key obligatoire. Pour reprendre la même mutation, réutiliser la même clé et le même contenu. Écritures et idempotence.

Creer ou mettre a jour une operation externe

cURL

curl --request PUT \
  --url https://partner-api.marko.fr/v1/operations/external/{external_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "name": "Clubfunding Demo Deal",
  "status": "Projet émis",
  "type_investissement": "dette_senior",
  "type_operation": "acquisition_detention",
  "classe_actif": "residentiel",
  "statut_interne": "analyse",
  "statut_operationnel": [
    "commercialisation"
  ],
  "sous_classe_actif": "residentiel_coliving",
  "data": {
    "adresse": "12 rue de la Paix, Paris"
  },
  "kpi_snapshot": {
    "date_reference": "2026-07-15",
    "crd_total": 2500000,
    "valeur_venale": 3400000,
    "ltv": 0.7353
  }
}
'

200

{
  "external_id": "CF-OP-001",
  "marko_id": "44444444-4444-4444-4444-444444444444",
  "outcome": "updated",
  "resource": {
    "id": "44444444-4444-4444-4444-444444444444",
    "spv_id": null,
    "lead_operateur_id": null,
    "name": "Clubfunding Demo Deal - Mise à jour",
    "status": "custom__a3e08c7bde__projet_emis",
    "type_investissement": "dette_senior",
    "type_operation": "acquisition_detention",
    "classe_actif": "residentiel",
    "statut_interne": "analyse",
    "statut_operationnel": [
      "commercialisation"
    ],
    "sous_classe_actif": "residentiel_coliving",
    "data": {
      "adresse": "14 rue de la Paix, Paris"
    },
    "created_at": "2026-08-22T08:00:00Z",
    "updated_at": "2026-08-22T09:30:00Z"
  },
  "taxonomy_additions": [],
  "request_id": "req_cf_operation_update"
}

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

name · string · required

Nom de la ressource. Les recherches exactes et partielles sont décrites au niveau de la route.

Required string length: 1 - 255

spv_id · string<uuid> | null

UUID MARKO de la SPV.

lead_operateur_id · string<uuid> | null

UUID MARKO de l'opérateur principal de l'opération.

existing_marko_id · string<uuid> | null

UUID d'une ressource MARKO existante à associer lors du premier upsert externe; la cible doit être accessible et compatible.

status · string | null

Statut métier de l'opération. Pour une écriture externe, consulter la dimension operation_status de GET /taxonomies.

Required string length: 1 - 255

type_investissement · string | null

Code de type d'investissement; consulter la dimension investment_type de GET /taxonomies.

Required string length: 1 - 255

type_operation · string | null

Code de type d'opération; consulter la dimension operation_type de GET /taxonomies.

Required string length: 1 - 255

classe_actif · string | null

Classe d'actif de l'opération. Pour une écriture externe, consulter la dimension asset_class de GET /taxonomies.

Required string length: 1 - 255

statut_interne · string | null

Code de statut interne de l'opération; consulter la dimension internal_status de GET /taxonomies.

Required string length: 1 - 255

statut_operationnel · string[] | null

Codes de statuts opérationnels de l'opération; consulter la dimension operational_status de GET /taxonomies.

Maximum array length: 100

Required string length: 1 - 255

sous_classe_actif · string | null

Sous-classe d'actif de l'opération.

data · Data · object

Données métier de l'opération. Consultez GET /field-definitions pour les clés, types et unités disponibles; ne déduisez pas les unités des noms.

kpi_snapshot · ExternalKpiSnapshotInput · object | null

Indicateurs financiers à la date de référence; utiliser les unités définies dans le guide Pagination et données.

Show child attributes

Response

200

application/json

Successful response for the accompanying request example

external_id · string · required

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

marko_id · string<uuid> · required

Identifiant MARKO résolu ou créé; conservez-le pour les appels ultérieurs.

outcome · enum<string> · required

Résultat de la synchronisation: created, updated, noop, restored ou bound. Conserver marko_id quel que soit ce résultat.

Available options: created, updated, noop, restored, bound

resource · ExternalOperationResourceResponse · object · required

État de la ressource MARKO après la synchronisation externe.

Show child attributes

request_id · string · required

Identifiant de corrélation pour le diagnostic de la requête.

taxonomy_additions · EntityTaxonomyOptionResponse · object[]

Options de taxonomie créées par cet upsert. Conservez les codes retournés; le suffixe custom__ n'est pas prévisible.

Show child attributes