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

# Relancer les éléments échoués

> Réenfile un job failed ou partial; les éléments déjà terminés restent des no-op.



## OpenAPI

````yaml https://partner-api.marko.fr/v1/openapi.json post /import-jobs/{job_id}/retry
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.
servers:
  - url: https://partner-api.marko.fr/v1
security:
  - BearerAuth: []
externalDocs:
  description: Download the matching Postman collection.
  url: /v1/postman.json
paths:
  /import-jobs/{job_id}/retry:
    post:
      tags:
        - import-jobs
      summary: Relancer les éléments échoués
      description: >-
        Réenfile un job failed ou partial; les éléments déjà terminés restent
        des no-op.
      operationId: import-jobs_retry
      parameters:
        - in: path
          name: job_id
          required: true
          schema:
            type: string
            format: uuid
          example: 88888888-8888-8888-8888-888888888888
        - in: header
          name: X-Request-ID
          required: false
          description: >-
            Partner-generated correlation identifier echoed in logs and error
            payloads.
          schema:
            type: string
          example: marko-import-jobs-retry
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                properties:
                  job_id:
                    format: uuid
                    title: Job Id
                    type: string
                  status:
                    title: Status
                    type: string
                  total_operations:
                    title: Total Operations
                    type: integer
                  total_notes:
                    title: Total Notes
                    type: integer
                  processed_items:
                    title: Processed Items
                    type: integer
                  completed_items:
                    title: Completed Items
                    type: integer
                  noop_items:
                    title: Noop Items
                    type: integer
                  failed_items:
                    title: Failed Items
                    type: integer
                  conflict_items:
                    title: Conflict Items
                    type: integer
                  cancel_requested:
                    title: Cancel Requested
                    type: boolean
                  accepted_at:
                    anyOf:
                      - format: date-time
                        type: string
                      - type: 'null'
                    default: null
                    title: Accepted At
                  started_at:
                    anyOf:
                      - format: date-time
                        type: string
                      - type: 'null'
                    default: null
                    title: Started At
                  completed_at:
                    anyOf:
                      - format: date-time
                        type: string
                      - type: 'null'
                    default: null
                    title: Completed At
                  created_at:
                    format: date-time
                    title: Created At
                    type: string
                  updated_at:
                    format: date-time
                    title: Updated At
                    type: string
                  results_url:
                    title: Results Url
                    type: string
                  operation_id:
                    anyOf:
                      - type: string
                        format: uuid
                      - type: 'null'
                    default: null
                    title: Operation Id
                  error_code:
                    anyOf:
                      - type: string
                      - type: 'null'
                    default: null
                    title: Error Code
                  error_message:
                    anyOf:
                      - type: string
                      - type: 'null'
                    default: null
                    title: Error Message
                required:
                  - job_id
                  - status
                  - total_operations
                  - total_notes
                  - processed_items
                  - completed_items
                  - noop_items
                  - failed_items
                  - conflict_items
                  - cancel_requested
                  - created_at
                  - updated_at
                  - results_url
                title: ExternalImportJobResponse
                type: object
              example:
                job_id: 88888888-8888-8888-8888-888888888888
                status: queued
                total_operations: 500
                total_notes: 5000
                processed_items: 0
                completed_items: 0
                noop_items: 0
                failed_items: 0
                conflict_items: 0
                cancel_requested: false
                created_at: '2026-07-16T08:00:00Z'
                updated_at: '2026-07-16T08:05:00Z'
                results_url: /v1/import-jobs/88888888-8888-8888-8888-888888888888/items
        '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:
    ProblemDetails:
      type: object
      required:
        - title
        - status
        - detail
      properties:
        type:
          type: string
          default: about:blank
        title:
          type: string
        status:
          type: integer
        detail:
          type: string
        request_id:
          type: string
        scope:
          type: string
        route_id:
          type: string
        reason_code:
          type: string
  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.

````