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

# Exercer le droit à l'effacement pour le sujet délégué

> Exige une allowlist explicite sur la clé et la capacité `rgpd_erasure`, avec `{"confirm": true}`.

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

**Délégation utilisateur :** exactement un header `X-Marko-Delegated-User-Id` ou `X-Marko-Delegated-User-Email`.

**Accès complémentaire :** allowlist utilisateur explicite sur la clé et capacité `rgpd_erasure`. Le sujet doit être approuvé et appartenir à la même entité.

**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).

[Export, inventaire et effacement RGPD](/privacy-guide).



## OpenAPI

````yaml /openapi.json delete /users/me/rgpd/erasure
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:
  /users/me/rgpd/erasure:
    delete:
      tags:
        - users
      summary: Exercer le droit à l'effacement pour le sujet délégué
      description: >-
        Exige une allowlist explicite sur la clé et la capacité `rgpd_erasure`,
        avec `{"confirm": true}`.


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


        **Délégation utilisateur :** exactement un header
        `X-Marko-Delegated-User-Id` ou `X-Marko-Delegated-User-Email`.


        **Accès complémentaire :** allowlist utilisateur explicite sur la clé et
        capacité `rgpd_erasure`. Le sujet doit être approuvé et appartenir à la
        même entité.


        **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).


        [Export, inventaire et effacement RGPD](/privacy-guide).
      operationId: users_rgpd_erasure
      parameters:
        - in: header
          name: X-Request-ID
          required: false
          description: >-
            Partner-generated correlation identifier echoed in logs and error
            payloads.
          schema:
            type: string
          example: marko-users-rgpd-erasure
        - 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: ^[!-~]+$
        - name: X-Marko-Delegated-User-Id
          in: header
          required: false
          schema:
            type: string
          description: >-
            Fournir exactement un des deux headers de délégation (Id ou Email),
            dans la même entité. Ils sont mutuellement exclusifs. Voir le guide
            Scopes et délégation.
        - name: X-Marko-Delegated-User-Email
          in: header
          required: false
          schema:
            type: string
          description: >-
            Fournir exactement un des deux headers de délégation (Id ou Email),
            dans la même entité. Ils sont mutuellement exclusifs. Voir le guide
            Scopes et délégation.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DelegatedUserErasureRequest'
            example:
              confirm: true
      responses:
        '200':
          description: Dossier d'effacement terminé; réponse limitée aux métadonnées.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DelegatedErasureResult'
              example:
                privacy_case_id: 11111111-1111-4111-8111-111111111111
                status: intake
                result_mode: metadata_only
                reconciliation_required: false
                manual_review_required: false
                certificate_reference: null
                completed_at: null
                actions:
                  - delegated_erasure_completed
                replayed: false
          headers:
            Idempotency-Key:
              schema:
                type: string
              description: Clé d'idempotence utilisée pour l'action.
            X-Marko-Idempotency-Key-Source:
              schema:
                type: string
                enum:
                  - client
                  - server
              description: Origine de la clé utilisée.
            X-Marko-Idempotency-TTL-Seconds:
              schema:
                type: integer
              description: Durée de rétention annoncée pour cette action, en secondes.
        '202':
          description: Effacement durable accepté; le dossier n'est pas encore terminé.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DelegatedErasureResult'
          headers:
            Idempotency-Key:
              schema:
                type: string
              description: Clé d'idempotence utilisée pour l'action.
            X-Marko-Idempotency-Key-Source:
              schema:
                type: string
                enum:
                  - client
                  - server
              description: Origine de la clé utilisée.
            X-Marko-Idempotency-TTL-Seconds:
              schema:
                type: integer
              description: Durée de rétention annoncée pour cette action, en secondes.
        '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: >-
            Not Found — refus déclaré dans le handler ou un helper de cette
            route.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
        '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
        '503':
          description: >-
            Service Unavailable — refus déclaré dans le handler ou un helper de
            cette route.
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/ProblemDetails'
      deprecated: false
      security:
        - BearerAuth: []
components:
  schemas:
    DelegatedUserErasureRequest:
      properties:
        confirm:
          type: boolean
          title: Confirm
          default: false
          description: >-
            Confirmation explicite exigée pour cette action; le scope seul ne
            remplace pas cette confirmation.
      type: object
      title: DelegatedUserErasureRequest
    DelegatedErasureResult:
      type: object
      properties:
        privacy_case_id:
          type: string
          format: uuid
          description: UUID du dossier durable de traitement RGPD.
        status:
          type: string
          enum:
            - intake
            - verifying
            - in_progress
            - waiting_customer
            - completed
            - blocked
            - cancelled
          description: >-
            État du dossier d'effacement; une réponse accepted n'est pas une
            confirmation d'effacement terminé.
        result_mode:
          type: string
          const: metadata_only
          description: >-
            Mode de restitution du résultat d'effacement; la réponse expose les
            métadonnées du dossier.
        reconciliation_required:
          type: boolean
          description: >-
            Indique que le résultat doit encore être rapproché de l'état réel du
            dossier.
        manual_review_required:
          type: boolean
          description: >-
            Indique qu'une revue humaine reste nécessaire pour ce dossier ou
            cette action.
        certificate_reference:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            Référence du certificat d'effacement, si elle existe; null ne
            constitue pas une preuve d'effacement.
        completed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          description: Date de fin, lorsqu'une exécution ou un traitement est terminé.
        actions:
          type: array
          items:
            type: string
            enum:
              - delegated_erasure_completed
              - delegated_erasure_blocked
              - delegated_erasure_reconciliation_pending
          description: >-
            Actions d'effacement enregistrées dans le dossier; leur présence ne
            signifie pas que toutes sont terminées.
        replayed:
          type: boolean
          description: >-
            Indique qu'une réponse liée à la même intention a été retrouvée et
            rejouée.
      required:
        - privacy_case_id
        - status
        - result_mode
        - reconciliation_required
        - manual_review_required
        - certificate_reference
        - completed_at
        - actions
        - replayed
    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.
  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.