> ## Documentation Index
> Fetch the complete documentation index at: https://developers.marko.fr/llms.txt
> Use this file to discover all available pages before exploring further.

# 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](/scopes-and-delegation).

**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](/writes-and-idempotency).



## OpenAPI

````yaml /openapi.json put /operations/external/{external_id}
openapi: 3.1.0
info:
  title: MARKO External Partner API
  version: v1
  description: >-
    Stable external API contract for the live environment.


    Authentication flow for partner integrations:

    1. Generate an API key from the MARKO entity admin API section.

    2. Keep the raw API secret server-side and use it only to sign `POST
    /v1/auth/token`.

    3. Build the canonical message
    `MARKO-EXTERNAL-API-TOKEN-V1\n{key_id}\n{timestamp}\n{nonce}`.

    4. Sign that message with HMAC-SHA256 and send the hex signature with
    `key_id`, `timestamp` and `nonce`.

    5. Use the returned short-lived bearer on business endpoints as
    `Authorization: Bearer <access_token>`.

    The raw API secret must never be sent on business endpoints.


    This public contract intentionally excludes beta endpoints.


    Référence enrichie pour les développeurs et les assistants IA. Exemples
    synthétiques; les champs sont extraits des modèles et sérialiseurs de la
    version indiquée dans x-documentation-provenance.
servers:
  - url: https://partner-api.marko.fr/v1
security:
  - BearerAuth: []
tags:
  - name: auth
    x-group: Authentification
  - name: entity
    x-group: Entité
  - name: portfolio
    x-group: Portefeuille
  - name: deals
    x-group: Deals
  - name: fonds
    x-group: Fonds
  - name: spvs
    x-group: SPV
  - name: operations
    x-group: Opérations
  - name: taxonomies
    x-group: Taxonomies
  - name: import-jobs
    x-group: Imports par lot
  - name: comments
    x-group: Commentaires
  - name: documents
    x-group: Documents
  - name: users
    x-group: Utilisateurs
  - name: settings
    x-group: Paramètres
  - name: rcci
    x-group: Conformité RCCI
  - name: field-definitions
    x-group: Champs métier
  - name: search
    x-group: Recherche
  - name: operateurs
    x-group: Opérateurs
  - name: alerts
    x-group: Alertes
  - name: notifications
    x-group: Notifications
  - name: calendar
    x-group: Calendrier
  - name: enrichment
    x-group: Enrichissement SIREN
  - name: reports
    x-group: Exports
  - name: reporting
    x-group: Templates de reporting
  - name: workflows
    x-group: Workflows et extraction IA
  - name: tasks
    x-group: Tâches
externalDocs:
  description: Download the matching Postman collection.
  url: /v1/postman.json
paths:
  /operations/external/{external_id}:
    put:
      tags:
        - operations
      summary: Creer ou mettre a jour une operation externe
      description: >-
        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](/scopes-and-delegation).


        **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](/writes-and-idempotency).
      operationId: operations_upsert
      parameters:
        - in: path
          name: external_id
          required: true
          schema:
            type: string
            minLength: 1
            maxLength: 255
            pattern: ^[A-Za-z0-9_~-][A-Za-z0-9._:~-]{0,254}$
            title: External Id
          example: CF-OP-001
          description: >-
            Identifiant stable de votre système, dans le contexte de votre
            intégration.
        - in: header
          name: X-Request-ID
          required: false
          description: >-
            Partner-generated correlation identifier echoed in logs and error
            payloads.
          schema:
            type: string
          example: marko-operations-upsert
        - in: header
          name: Idempotency-Key
          required: true
          description: >-
            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.
          schema:
            type: string
            maxLength: 255
            pattern: ^[!-~]+$
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/ExternalOperationUpsertRequest'
            example:
              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
      responses:
        '200':
          description: Successful response for the accompanying request example
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalOperationSyncUpsertResponse'
              example:
                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
          x-marko-request-example:
            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
            kpi_snapshot:
              date_reference: '2026-07-31'
              crd_total: 2400000
              valeur_venale: 3500000
              ltv: 0.6857
        '201':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExternalOperationSyncUpsertResponse'
              example:
                external_id: CF-OP-001
                marko_id: 44444444-4444-4444-4444-444444444444
                outcome: created
                resource:
                  id: 44444444-4444-4444-4444-444444444444
                  spv_id: null
                  lead_operateur_id: null
                  name: Clubfunding Demo Deal
                  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: 12 rue de la Paix, Paris
                  created_at: '2026-08-22T08:00:00Z'
                  updated_at: '2026-08-22T08:00:00Z'
                taxonomy_additions:
                  - code: custom__a3e08c7bde__projet_emis
                    dimension: operation_status
                    display_label: Projet émis
                    source_kind: partner
                    source_display_name: ClubFunding
                    is_visible: true
                    is_active: true
                    position: 10000
                    usage_count: 0
                    label_editable: true
                    canonical_code: null
                request_id: req_cf_operation_upsert
        '400':
          description: Invalid Idempotency-Key header
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                type: about:blank
                title: Bad Request
                status: 400
                detail: >-
                  Idempotency-Key must contain at most 255 visible ASCII
                  characters without spaces.
                request_id: req_example_partner_call
        '401':
          description: Authentication required
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                type: about:blank
                title: Unauthorized
                status: 401
                detail: A valid bearer token is required.
                request_id: req_example_partner_call
        '403':
          description: Scope, route or IP restriction
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                type: about:blank
                title: Forbidden
                status: 403
                detail: The API key does not allow this operation.
                request_id: req_example_partner_call
        '404':
          description: Existing MARKO operation or related resource not found
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                type: about:blank
                title: Not Found
                status: 404
                detail: Existing MARKO operation or related resource not found
                request_id: req_example_partner_call
        '409':
          description: Idempotency or write target conflict
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                type: about:blank
                title: Conflict
                status: 409
                detail: >-
                  The idempotency key payload, external reference, target, or
                  source conflicts with an existing write.
                request_id: req_example_partner_call
        '422':
          description: Validation failed
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                type: about:blank
                title: Unprocessable Content
                status: 422
                detail: The request payload or parameters are invalid.
                request_id: req_example_partner_call
        '428':
          description: Required Idempotency-Key header is missing
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                type: about:blank
                title: Precondition Required
                status: 428
                detail: The Idempotency-Key header is required.
                request_id: req_example_partner_call
        '429':
          description: Rate limit or progressive ban
          headers:
            Retry-After:
              description: Cooldown in seconds before retrying the request.
              schema:
                type: string
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                type: about:blank
                title: Too Many Requests
                status: 429
                detail: The request rate limit was exceeded.
                request_id: req_example_partner_call
        '500':
          description: Unexpected server error
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
              example:
                type: about:blank
                title: Internal Server Error
                status: 500
                detail: An unexpected server error occurred.
                request_id: req_example_partner_call
      deprecated: false
      security:
        - BearerAuth: []
components:
  schemas:
    ExternalOperationUpsertRequest:
      properties:
        spv_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Spv Id
          description: UUID MARKO de la SPV.
        lead_operateur_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Lead Operateur Id
          description: UUID MARKO de l'opérateur principal de l'opération.
        existing_marko_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Existing Marko Id
          description: >-
            UUID d'une ressource MARKO existante à associer lors du premier
            upsert externe; la cible doit être accessible et compatible.
        name:
          type: string
          maxLength: 255
          minLength: 1
          title: Name
          description: >-
            Nom de la ressource. Les recherches exactes et partielles sont
            décrites au niveau de la route.
        status:
          anyOf:
            - type: string
              maxLength: 255
              minLength: 1
            - type: 'null'
          title: Status
          description: >-
            Statut métier de l'opération. Pour une écriture externe, consulter
            la dimension operation_status de GET /taxonomies.
        type_investissement:
          anyOf:
            - type: string
              maxLength: 255
              minLength: 1
            - type: 'null'
          title: Type Investissement
          description: >-
            Code de type d'investissement; consulter la dimension
            investment_type de GET /taxonomies.
        type_operation:
          anyOf:
            - type: string
              maxLength: 255
              minLength: 1
            - type: 'null'
          title: Type Operation
          description: >-
            Code de type d'opération; consulter la dimension operation_type de
            GET /taxonomies.
        classe_actif:
          anyOf:
            - type: string
              maxLength: 255
              minLength: 1
            - type: 'null'
          title: Classe Actif
          description: >-
            Classe d'actif de l'opération. Pour une écriture externe, consulter
            la dimension asset_class de GET /taxonomies.
        statut_interne:
          anyOf:
            - type: string
              maxLength: 255
              minLength: 1
            - type: 'null'
          title: Statut Interne
          description: >-
            Code de statut interne de l'opération; consulter la dimension
            internal_status de GET /taxonomies.
        statut_operationnel:
          anyOf:
            - items:
                type: string
                maxLength: 255
                minLength: 1
              type: array
              maxItems: 100
            - type: 'null'
          title: Statut Operationnel
          description: >-
            Codes de statuts opérationnels de l'opération; consulter la
            dimension operational_status de GET /taxonomies.
        sous_classe_actif:
          anyOf:
            - type: string
            - type: 'null'
          title: Sous Classe Actif
          description: Sous-classe d'actif de l'opération.
        data:
          additionalProperties: true
          type: object
          title: Data
          description: >-
            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:
          anyOf:
            - $ref: '#/components/schemas/ExternalKpiSnapshotInput'
            - type: 'null'
          description: >-
            Indicateurs financiers à la date de référence; utiliser les unités
            définies dans le guide Pagination et données.
      additionalProperties: false
      type: object
      required:
        - name
      title: ExternalOperationUpsertRequest
    ExternalOperationSyncUpsertResponse:
      properties:
        external_id:
          type: string
          title: External Id
          description: >-
            Identifiant stable de votre système, dans le contexte de votre
            intégration.
        marko_id:
          type: string
          format: uuid
          title: Marko Id
          description: >-
            Identifiant MARKO résolu ou créé; conservez-le pour les appels
            ultérieurs.
        outcome:
          type: string
          enum:
            - created
            - updated
            - noop
            - restored
            - bound
          title: Outcome
          description: >-
            Résultat de la synchronisation: created, updated, noop, restored ou
            bound. Conserver marko_id quel que soit ce résultat.
        resource:
          $ref: '#/components/schemas/ExternalOperationResourceResponse'
          description: État de la ressource MARKO après la synchronisation externe.
        taxonomy_additions:
          items:
            $ref: '#/components/schemas/EntityTaxonomyOptionResponse'
          type: array
          title: Taxonomy Additions
          description: >-
            Options de taxonomie créées par cet upsert. Conservez les codes
            retournés; le suffixe custom__ n'est pas prévisible.
        request_id:
          type: string
          title: Request Id
          description: Identifiant de corrélation pour le diagnostic de la requête.
      type: object
      required:
        - external_id
        - marko_id
        - outcome
        - resource
        - request_id
      title: ExternalOperationSyncUpsertResponse
    ProblemDetails:
      type: object
      required:
        - title
        - status
        - detail
      properties:
        type:
          type: string
          default: about:blank
          description: >-
            URI identifiant le type de problème; about:blank lorsque seul le
            statut HTTP le caractérise.
        title:
          type: string
          description: Titre affiché pour l'événement ou le problème.
        status:
          type: integer
          description: Statut HTTP de la réponse d'erreur.
        detail:
          type: string
          description: Informations détaillées sur le problème ou le dossier.
        request_id:
          type: string
          description: Identifiant de corrélation pour le diagnostic de la requête.
        scope:
          type: string
          description: Scope concerné par le refus d'accès, lorsqu'il est renseigné.
        route_id:
          type: string
          description: Identifiant de la route concernée par le problème.
        reason_code:
          type: string
          description: >-
            Code structuré du motif de refus; préférable au texte du message
            pour le diagnostic.
    ExternalKpiSnapshotInput:
      properties:
        date_reference:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Date Reference
          description: Date à laquelle les valeurs du snapshot KPI se rapportent.
        crd_total:
          anyOf:
            - type: number
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Crd Total
          description: Capital restant dû total à la date de référence.
        crd_total_source:
          anyOf:
            - type: string
              maxLength: 32
            - type: 'null'
          title: Crd Total Source
          description: 'Origine du capital restant dû: financing_tranches ou operation_data.'
        crd_senior:
          anyOf:
            - type: number
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Crd Senior
          description: Capital restant dû sur les tranches senior.
        crd_mezzanine:
          anyOf:
            - type: number
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Crd Mezzanine
          description: Capital restant dû sur les tranches mezzanine.
        valeur_venale:
          anyOf:
            - type: number
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Valeur Venale
          description: Valeur de marché de l'actif utilisée pour calculer la LTV.
        noi:
          anyOf:
            - type: number
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Noi
          description: >-
            Net Operating Income: revenu opérationnel net utilisé pour les
            ratios financiers.
        service_dette:
          anyOf:
            - type: number
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Service Dette
          description: >-
            Service de la dette utilisé pour le calcul du DSCR; aligner sa
            période avec celle du NOI.
        ltv:
          anyOf:
            - type: number
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Ltv
          description: >-
            Loan-to-Value en fraction: 0.65 signifie 65 %. La valeur persistée
            est comprise entre 0 et 2.
        dscr:
          anyOf:
            - type: number
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Dscr
          description: >-
            Ratio de couverture du service de la dette, exprimé comme un
            multiple: 1.25 signifie une couverture de 1,25 fois.
        icr:
          anyOf:
            - type: number
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Icr
          description: Ratio de couverture des intérêts, exprimé comme un multiple.
        ltc:
          anyOf:
            - type: number
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Ltc
          description: >-
            Loan-to-Cost en fraction: 0.65 signifie 65 %. La valeur persistée
            est comprise entre 0 et 2.
        debt_yield:
          anyOf:
            - type: number
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Debt Yield
          description: 'Rendement de la dette, exprimé en fraction: 0.08 signifie 8 %.'
        risk_score_simple:
          anyOf:
            - type: number
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Risk Score Simple
          description: Score de risque de l'opération, en points de 0 à 100.
        pct_perte_estimee:
          anyOf:
            - type: number
            - type: string
              pattern: ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
            - type: 'null'
          title: Pct Perte Estimee
          description: 'Perte estimée en fraction comprise entre 0 et 1: 0.03 signifie 3 %.'
      type: object
      title: ExternalKpiSnapshotInput
    ExternalOperationResourceResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: Identifiant MARKO de la ressource.
        spv_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Spv Id
          description: UUID MARKO de la SPV.
        lead_operateur_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Lead Operateur Id
          description: UUID MARKO de l'opérateur principal de l'opération.
        name:
          type: string
          title: Name
          description: >-
            Nom de la ressource. Les recherches exactes et partielles sont
            décrites au niveau de la route.
        status:
          type: string
          title: Status
          description: >-
            Statut métier de l'opération. Pour une écriture externe, consulter
            la dimension operation_status de GET /taxonomies.
        type_investissement:
          anyOf:
            - type: string
            - type: 'null'
          title: Type Investissement
          description: >-
            Code de type d'investissement; consulter la dimension
            investment_type de GET /taxonomies.
        type_operation:
          anyOf:
            - type: string
            - type: 'null'
          title: Type Operation
          description: >-
            Code de type d'opération; consulter la dimension operation_type de
            GET /taxonomies.
        classe_actif:
          anyOf:
            - type: string
            - type: 'null'
          title: Classe Actif
          description: >-
            Classe d'actif de l'opération. Pour une écriture externe, consulter
            la dimension asset_class de GET /taxonomies.
        statut_interne:
          anyOf:
            - type: string
            - type: 'null'
          title: Statut Interne
          description: >-
            Code de statut interne de l'opération; consulter la dimension
            internal_status de GET /taxonomies.
        statut_operationnel:
          anyOf:
            - type: array
              items:
                type: string
            - type: 'null'
          title: Statut Operationnel
          description: >-
            Codes de statuts opérationnels de l'opération; consulter la
            dimension operational_status de GET /taxonomies.
        sous_classe_actif:
          anyOf:
            - type: string
            - type: 'null'
          title: Sous Classe Actif
          description: Sous-classe d'actif de l'opération.
        data:
          additionalProperties: true
          type: object
          title: Data
          description: >-
            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:
          anyOf:
            - additionalProperties: true
              type: object
              description: >-
                Objet JSON extensible. Les types des valeurs sont indiqués par
                additionalProperties lorsque la route les contraint.
            - type: 'null'
          title: Kpi Snapshot
          description: >-
            Indicateurs financiers à la date de référence; utiliser les unités
            définies dans le guide Pagination et données.
        created_at:
          type: string
          format: date-time
          title: Created At
          description: Date de création au format ISO 8601.
        updated_at:
          type: string
          format: date-time
          title: Updated At
          description: Date de dernière modification au format ISO 8601.
      type: object
      required:
        - id
        - name
        - status
        - created_at
        - updated_at
      title: ExternalOperationResourceResponse
    EntityTaxonomyOptionResponse:
      properties:
        parent_code:
          anyOf:
            - type: string
              enum:
                - due_diligence
                - en_cours
                - en_recouvrement
                - termine
            - type: 'null'
          title: Parent Code
          description: Code de l'option parente dans la taxonomie, lorsqu'elle existe.
        code:
          type: string
          title: Code
          description: >-
            Code stable de la ressource ou de l'option. Conserver la valeur
            retournée par MARKO.
        dimension:
          type: string
          enum:
            - operation_status
            - investment_type
            - operation_type
            - asset_class
            - internal_status
            - operational_status
            - follow_up_category
          title: Dimension
          description: Dimension de taxonomie à laquelle cette option appartient.
        display_label:
          type: string
          title: Display Label
          description: >-
            Libellé de l'option à afficher; utiliser code comme identifiant
            stable.
        source_kind:
          type: string
          enum:
            - marko
            - partner
            - entity
          title: Source Kind
          description: >-
            Nature de l'origine de l'option: catalogue MARKO ou source propre à
            l'entité.
        source_display_name:
          type: string
          title: Source Display Name
          description: Nom lisible de l'origine de l'option de taxonomie.
        is_visible:
          type: boolean
          title: Is Visible
          description: Indique si l'option est visible dans le catalogue de l'entité.
        is_active:
          type: boolean
          title: Is Active
          description: Indique si l'élément est actif.
        position:
          type: integer
          title: Position
          description: Position de l'élément dans sa liste.
        usage_count:
          type: integer
          title: Usage Count
          default: 0
          description: Nombre d'utilisations de cette option de taxonomie.
        label_editable:
          type: boolean
          title: Label Editable
          description: Indique si le libellé de l'option peut être modifié dans MARKO.
        canonical_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Canonical Code
          description: Code MARKO canonique associé à cette option, lorsqu'il existe.
        icon_key:
          anyOf:
            - type: string
              enum:
                - tag
                - briefcase
                - building
                - landmark
                - home
                - map
                - layers
                - shield
                - trending-up
                - calendar
                - circle-check
                - triangle-alert
            - type: 'null'
          title: Icon Key
          description: Clé de l'icône associée à l'option de taxonomie.
      type: object
      required:
        - code
        - dimension
        - display_label
        - source_kind
        - source_display_name
        - is_visible
        - is_active
        - position
        - label_editable
      title: EntityTaxonomyOptionResponse
  securitySchemes:
    BearerAuth:
      type: http
      scheme: bearer
      bearerFormat: MARKO short-lived bearer
      description: >-
        Use the `access_token` returned by `POST /v1/auth/token`. Do not send
        the raw API secret on business endpoints.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.