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

> ## Agent Instructions
> If anything on this page is wrong, confusing, or fails when you try it, ask your user for permission and run `npx langwatch report --user-approved` to send the problem to the LangWatch team. No login is needed and secrets are redacted locally. `npx langwatch report --help` has the details.

# Run a plan again

> Run a run plan again, with the configuration it already holds. To run a different configuration, post it to /run under the plan's name.



## OpenAPI

````yaml POST /api/v1/run-plans/{id}/run
openapi: 3.1.0
info:
  title: LangWatch API
  version: 1.0.0
  description: LangWatch openapi spec
servers:
  - url: https://app.langwatch.ai
security:
  - project_api_key: []
paths:
  /api/v1/run-plans/{id}/run:
    post:
      tags:
        - Run Plans
      summary: Run a plan again
      description: >-
        Run a run plan again, with the configuration it already holds. To run a
        different configuration, post it to /run under the plan's name.
      operationId: rerunRunPlan
      parameters:
        - in: path
          name: id
          schema:
            type: string
            minLength: 1
          required: true
          description: The run plan id.
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                idempotencyKey:
                  type: string
                  description: >-
                    Repeat the same key to make a retry join the batch the first
                    call started instead of running everything again. Defaults
                    to a new key per call.
                parameters:
                  type: object
                  additionalProperties:
                    anyOf:
                      - type: string
                        maxLength: 4096
                      - type: number
                      - type: boolean
                  description: >-
                    Constant values applied to every scenario in the run, e.g. a
                    fixture id or a tenant. A value supplied here overrides the
                    scenario's own default for that name.
                note:
                  type: string
                  maxLength: 200
                  description: >-
                    One short line describing why this batch was run, e.g. a
                    commit hash or what you changed. It is stored on every run
                    of the batch and shown beside the run in the platform. Up to
                    200 characters.
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  scheduled:
                    type: boolean
                    description: True once the runs are queued.
                  batchRunId:
                    type: string
                    description: The id of this batch. Every run started here carries it.
                  setId:
                    type: string
                    description: The result set the batch is filed under in the platform.
                  jobCount:
                    type: number
                    description: How many runs were queued.
                  skippedArchived:
                    type: object
                    properties:
                      scenarios:
                        type: array
                        items:
                          type: string
                        description: Scenarios left out because they are archived.
                      targets:
                        type: array
                        items:
                          type: string
                        description: Targets left out because they are archived.
                    required:
                      - scenarios
                      - targets
                    description: What the run left out, and why.
                  items:
                    type: array
                    items:
                      type: object
                      properties:
                        scenarioRunId:
                          type: string
                          description: The id of this single run.
                        scenarioId:
                          type: string
                          description: The scenario that was run.
                        target:
                          type: object
                          properties:
                            type:
                              type: string
                              enum:
                                - prompt
                                - http
                                - code
                                - workflow
                              description: What kind of thing the scenarios run against.
                            referenceId:
                              type: string
                              description: >-
                                The id of the prompt, agent or workflow to run
                                against.
                          required:
                            - type
                            - referenceId
                          description: What it was run against.
                        name:
                          type:
                            - string
                            - 'null'
                          description: The scenario name, when known.
                      required:
                        - scenarioRunId
                        - scenarioId
                        - target
                        - name
                    description: Every run this call queued.
                  runPlanId:
                    type: string
                    description: The run plan this run was filed under.
                  planName:
                    type: string
                    description: The name that plan answers to.
                  created:
                    type: boolean
                    description: >-
                      True when this run created the plan, false when it joined
                      a plan already there.
                  platformUrl:
                    type: string
                    format: uri
                    description: Where to watch this run in the LangWatch platform.
                required:
                  - scheduled
                  - batchRunId
                  - setId
                  - jobCount
                  - skippedArchived
                  - items
                  - runPlanId
                  - planName
                  - created
                  - platformUrl
      security:
        - project_api_key: []
components:
  securitySchemes:
    project_api_key:
      type: apiKey
      in: header
      name: X-Auth-Token
      description: >-
        Project API key for sending traces and accessing project-scoped
        resources. Format: sk-lw-... (no underscore). Obtain one by creating a
        project via the Admin API or the LangWatch UI.

````