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

# Réordonner une tâche

> Déplace une tâche dans le board Kanban.

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



## OpenAPI

````yaml /openapi.json put /tasks/reorder
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:
  /tasks/reorder:
    put:
      tags:
        - tasks
      summary: Réordonner une tâche
      description: >-
        Déplace une tâche dans le board Kanban.


        **Scope requis :** `tasks:write`. [Scopes et
        délégation](/scopes-and-delegation).
      operationId: tasks_reorder
      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-tasks-reorder
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/KanbanTaskReorder'
            example:
              task_id: 11111111-aaaa-bbbb-cccc-222222222222
              new_status: in_progress
              new_sort_order: 2
        required: true
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/KanbanTaskResponse'
              example:
                id: 11111111-aaaa-bbbb-cccc-222222222222
                target_type: operation
                target_name: example
                target_url: example
                titre: example
                statut: in_progress
                categorie: example
                sort_order: 0
        '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:
    KanbanTaskReorder:
      properties:
        task_id:
          type: string
          format: uuid
          title: Task Id
          description: UUID de la tâche Kanban à déplacer.
        new_status:
          type: string
          title: New Status
          description: Statut cible de la tâche après son déplacement.
        new_sort_order:
          type: integer
          minimum: 0
          title: New Sort Order
          description: Nouvelle position de la tâche dans le périmètre de réordonnancement.
        ordering_scope:
          type: string
          enum:
            - operation
            - dashboard
          title: Ordering Scope
          default: operation
          description: 'Périmètre du déplacement: board de l''opération ou board consolidé.'
        expected_updated_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Expected Updated At
          description: >-
            Optimistic-concurrency guard: the task's updated_at the client based
            its move on. A mismatch returns a typed 409 with the fresh state
            instead of silently overwriting a concurrent move.
      type: object
      required:
        - task_id
        - new_status
        - new_sort_order
      title: KanbanTaskReorder
      description: Payload for drag & drop reorder.
    KanbanTaskResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: Identifiant MARKO de la ressource.
        operation_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Operation Id
          description: UUID MARKO de l'opération.
        operateur_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Operateur Id
          description: UUID MARKO de l'opérateur.
        fond_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Fond Id
          description: UUID MARKO du fonds.
        spv_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Spv Id
          description: UUID MARKO de la SPV.
        target_type:
          type: string
          enum:
            - operation
            - operateur
            - fond
            - spv
          title: Target Type
          description: Type de ressource à laquelle la tâche se rapporte.
        target_name:
          type: string
          title: Target Name
          description: Nom de la ressource à laquelle la tâche se rapporte.
        target_url:
          type: string
          title: Target Url
          description: Lien vers la ressource concernée dans l'interface MARKO.
        phase_key:
          anyOf:
            - type: string
            - type: 'null'
          title: Phase Key
          description: Clé de phase métier à laquelle la tâche est rattachée.
        operation_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Operation Name
          description: Nom de l'opération concernée.
        operation_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Operation Url
          description: Lien vers la fiche de l'opération dans MARKO.
        operation_piloting_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Operation Piloting Url
          description: Lien vers le pilotage de l'opération dans MARKO.
        fond_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Fond Name
          description: Nom du fonds associé à la ressource.
        spv_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Spv Name
          description: Nom de la SPV associée à la ressource.
        responsable_interne:
          anyOf:
            - type: string
            - type: 'null'
          title: Responsable Interne
          description: Responsable interne associé à la ressource.
        operateur_nom:
          anyOf:
            - type: string
            - type: 'null'
          title: Operateur Nom
          description: Nom de l'opérateur associé à la cible de la tâche.
        asset_manager_nom:
          anyOf:
            - type: string
            - type: 'null'
          title: Asset Manager Nom
          description: Nom de l'asset manager associé à la cible de la tâche.
        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.
        titre:
          type: string
          title: Titre
          description: Titre de la tâche Kanban.
        description:
          anyOf:
            - type: string
            - type: 'null'
          title: Description
          description: Description libre de la ressource.
        statut:
          type: string
          title: Statut
          description: Statut de la tâche Kanban.
        categorie:
          type: string
          title: Categorie
          description: >-
            Catégorie de la tâche Kanban, distincte de sa priorité et de son
            statut.
        priority:
          type: string
          enum:
            - critique
            - haute
            - moyenne
            - basse
          title: Priority
          default: moyenne
          description: 'Priorité de la tâche: critique, haute, moyenne ou basse.'
        assignee_id:
          anyOf:
            - type: string
            - type: 'null'
          title: Assignee Id
          description: >-
            Identifiant utilisateur du responsable de la tâche; ce champ n'est
            pas nécessairement un UUID.
        due_date:
          anyOf:
            - type: string
              format: date
            - type: 'null'
          title: Due Date
          description: Date d'échéance de la tâche, au format YYYY-MM-DD.
        completed_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Completed At
          description: Date de fin, lorsqu'une exécution ou un traitement est terminé.
        sort_order:
          type: integer
          title: Sort Order
          description: Position de la tâche dans le board de son opération.
        dashboard_sort_order:
          type: integer
          title: Dashboard Sort Order
          default: 0
          description: Position de la tâche dans le board consolidé.
        archived_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Archived At
          description: Date d'archivage de la tâche; null si elle n'est pas archivée.
        labels:
          items:
            $ref: '#/components/schemas/KanbanLabelResponse'
          type: array
          title: Labels
          description: Labels actuellement associés à la tâche.
        created_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Created At
          description: Date de création au format ISO 8601.
        updated_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Updated At
          description: Date de dernière modification au format ISO 8601.
        idempotency_receipt:
          anyOf:
            - $ref: '#/components/schemas/ManualCreationIdempotencyReceipt'
            - type: 'null'
          description: >-
            Reçu de création manuelle indiquant notamment si une création
            précédente a été rejouée.
      type: object
      required:
        - id
        - target_type
        - target_name
        - target_url
        - titre
        - statut
        - categorie
        - sort_order
      title: KanbanTaskResponse
    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.
    KanbanLabelResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: Identifiant MARKO de la ressource.
        name:
          type: string
          title: Name
          description: >-
            Nom de la ressource. Les recherches exactes et partielles sont
            décrites au niveau de la route.
        color:
          type: string
          title: Color
          description: >-
            Couleur d'affichage; respecter les valeurs ou le format indiqués
            dans le schéma.
      type: object
      required:
        - id
        - name
        - color
      title: KanbanLabelResponse
    ManualCreationIdempotencyReceipt:
      properties:
        client_request_id:
          type: string
          title: Client Request Id
          description: >-
            Identifiant durable de la création manuelle; conserver la même
            valeur pour reprendre la même création.
        actor_id:
          type: string
          title: Actor Id
          description: Identifiant de l'auteur de l'événement.
        capability:
          type: string
          title: Capability
          description: Capacité de création à laquelle se rapporte le reçu d'idempotence.
        payload_digest:
          type: string
          pattern: ^[0-9a-f]{64}$
          title: Payload Digest
          description: >-
            Empreinte du contenu de la création manuelle utilisée pour détecter
            une reprise incompatible.
        replayed:
          type: boolean
          title: Replayed
          default: false
          description: >-
            Indique qu'une réponse liée à la même intention a été retrouvée et
            rejouée.
      type: object
      required:
        - client_request_id
        - actor_id
        - capability
        - payload_digest
      title: ManualCreationIdempotencyReceipt
      description: Content-free binding returned on create and later readback.
  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.