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

# Restart a run at a task

> Start a new run that begins at one of an earlier run's tasks.

The tasks before it are seeded from what that run kept, so the work
that succeeded is not paid for twice. It runs **as you**, with the crew
re-resolved and access-checked as you; a pinned version that has moved
since is a 409 rather than a quiet substitution.



## OpenAPI

````yaml post /api/crew-runs/{run_id}/replay
openapi: 3.1.0
info:
  title: Nx1 AI API
  description: |

    AI API for Nx1 Data Platform Management and Automated Data Tasks.

    Authentication is required via PSK in Authorization header.

    Default PSK is | [ask a friend] |
  version: 0.10.2
servers: []
security: []
paths:
  /api/crew-runs/{run_id}/replay:
    post:
      tags:
        - Crew runs
      summary: Restart a run at a task
      description: |-
        Start a new run that begins at one of an earlier run's tasks.

        The tasks before it are seeded from what that run kept, so the work
        that succeeded is not paid for twice. It runs **as you**, with the crew
        re-resolved and access-checked as you; a pinned version that has moved
        since is a 409 rather than a quiet substitution.
      operationId: replay_run_api_crew_runs__run_id__replay_post
      parameters:
        - name: run_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            description: ID of the run to restart.
            title: Run Id
          description: ID of the run to restart.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CrewRunReplayRequest'
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CrewRunResponse'
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '409':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Conflict
        '422':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
          description: Unprocessable Content
      security:
        - OAuth2AuthorizationCodeBearer: []
        - APIKeyHeader: []
components:
  schemas:
    CrewRunReplayRequest:
      properties:
        from_task:
          type: integer
          minimum: 0
          title: From Task
          description: >-
            The task index to restart at. Tasks before it are seeded from what
            this run kept.
      type: object
      required:
        - from_task
      title: CrewRunReplayRequest
      description: Restart a run at one of its tasks.
    CrewRunResponse:
      properties:
        correlation_id:
          type: string
          title: Correlation Id
          description: ID for the crew run.
        status:
          $ref: '#/components/schemas/CrewRunStatusEnum'
          description: >-
            State of the run. Always `pending` here, since the run has only just
            started.
          default: pending
        message:
          anyOf:
            - type: string
            - type: 'null'
          title: Message
          description: Human-readable note about the run, such as which crew started.
      type: object
      required:
        - correlation_id
      title: CrewRunResponse
      description: Response returned after a crew run starts.
    ErrorResponse:
      properties:
        error:
          type: string
          title: Error
          description: A brief description of the error that occurred.
        code:
          type: integer
          title: Code
          description: The HTTP status code associated with the error.
          default: 500
      type: object
      required:
        - error
      title: ErrorResponse
    CrewRunStatusEnum:
      type: string
      enum:
        - pending
        - running
        - completed
        - failed
      title: CrewRunStatusEnum
  securitySchemes:
    OAuth2AuthorizationCodeBearer:
      type: oauth2
      flows:
        authorizationCode:
          scopes: {}
          authorizationUrl: >-
            https://sso-rapid.rapid.nx1cloud.com/realms/rapid/protocol/openid-connect/auth
          tokenUrl: >-
            https://sso-rapid.rapid.nx1cloud.com/realms/rapid/protocol/openid-connect/token
    APIKeyHeader:
      type: apiKey
      in: header
      name: Authorization-PSK

````

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