> ## 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.

# Mettre à jour un fonds

> Met à jour les métadonnées d'un fonds.

**Scope requis :** `fonds:write`. [Scopes et délégation](/scopes-and-delegation).



## OpenAPI

````yaml /openapi.json put /fonds/{fond_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:
  /fonds/{fond_id}:
    put:
      tags:
        - fonds
      summary: Mettre à jour un fonds
      description: >-
        Met à jour les métadonnées d'un fonds.


        **Scope requis :** `fonds:write`. [Scopes et
        délégation](/scopes-and-delegation).
      operationId: fonds_update
      parameters:
        - in: path
          name: fond_id
          required: true
          schema:
            type: string
            format: uuid
            title: Fond Id
          example: 22222222-2222-2222-2222-222222222222
          description: UUID MARKO du fonds.
        - in: header
          name: X-Request-ID
          required: false
          description: >-
            Partner-generated correlation identifier echoed in logs and error
            payloads.
          schema:
            type: string
          example: marko-fonds-update
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/FondUpdate'
            example:
              name: Clubfunding Debt I Updated
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FondResponse'
              example:
                name: Clubfunding Debt I Updated
                id: 22222222-2222-2222-2222-222222222222
                entity_id: 11111111-1111-4111-8111-111111111111
                created_at: '2026-10-01T10:00:00Z'
        '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
        '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
        '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:
    FondUpdate:
      properties:
        name:
          anyOf:
            - type: string
            - type: 'null'
          title: Name
          description: >-
            Nom de la ressource. Les recherches exactes et partielles sont
            décrites au niveau de la route.
        code:
          anyOf:
            - type: string
            - type: 'null'
          title: Code
          description: >-
            Code stable de la ressource ou de l'option. Conserver la valeur
            retournée par MARKO.
        status:
          anyOf:
            - $ref: '#/components/schemas/FondStatus'
            - type: 'null'
          description: Statut du fonds d'investissement.
        date_creation:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Date Creation
          description: >-
            Date de création de la société, du fonds ou du dossier; distincte de
            created_at dans MARKO.
        date_liquidation:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Date Liquidation
          description: Date de liquidation du fonds, lorsqu'elle est renseignée.
      type: object
      title: FondUpdate
    FondResponse:
      properties:
        name:
          type: string
          title: Name
          description: >-
            Nom de la ressource. Les recherches exactes et partielles sont
            décrites au niveau de la route.
        code:
          anyOf:
            - type: string
            - type: 'null'
          title: Code
          description: >-
            Code stable de la ressource ou de l'option. Conserver la valeur
            retournée par MARKO.
        status:
          $ref: '#/components/schemas/FondStatus'
          default: actif
          description: Statut du fonds d'investissement.
        date_creation:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Date Creation
          description: >-
            Date de création de la société, du fonds ou du dossier; distincte de
            created_at dans MARKO.
        date_liquidation:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Date Liquidation
          description: Date de liquidation du fonds, lorsqu'elle est renseignée.
        id:
          type: string
          format: uuid
          title: Id
          description: Identifiant MARKO de la ressource.
        entity_id:
          type: string
          format: uuid
          title: Entity Id
          description: Identifiant de l'entité MARKO à laquelle cette ressource appartient.
        created_at:
          type: string
          format: date-time
          title: Created At
          description: Date de création au format ISO 8601.
        spv_count:
          anyOf:
            - type: integer
            - type: 'null'
          title: Spv Count
          default: 0
          description: Nombre de SPV rattachées au fonds.
        document_values:
          $ref: '#/components/schemas/FondDocumentValuesResponse'
          description: Valeurs du fonds extraites de ses documents.
      type: object
      required:
        - name
        - id
        - entity_id
        - created_at
      title: FondResponse
    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.
    FondStatus:
      type: string
      enum:
        - en_levee_de_fonds
        - actif
        - en_liquidation
        - liquide
        - ferme
      title: FondStatus
      description: Statut du fond d'investissement.
    FondDocumentValuesResponse:
      properties:
        aum_du_fonds:
          anyOf:
            - type: number
            - type: 'null'
          title: Aum Du Fonds
          description: Actifs sous gestion de ce fonds, issus de ses valeurs documentaires.
        aum_des_fonds:
          anyOf:
            - type: number
            - type: 'null'
          title: Aum Des Fonds
          description: >-
            Actifs sous gestion agrégés des fonds, issus des valeurs
            documentaires disponibles.
        nombre_de_spv:
          anyOf:
            - type: integer
            - type: 'null'
          title: Nombre De Spv
          description: Nombre de SPV indiqué dans les valeurs documentaires du fonds.
      type: object
      title: FondDocumentValuesResponse
      description: >-
        Typed, read-only projection of the three AI Extract fund cells.


        These are document observations. They deliberately stay separate from
        the

        KPIs calculated from MARKO's linked SPVs and financing tranches.
  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.