> ## Documentation Index > Fetch the complete documentation index at: https://docs.internal.nscale.com/llms.txt > Use this file to discover all available pages before exploring further. # Dispatch policy-aware burn-in reruns > Calculate and dispatch safe reruns through the standard Job path. Multi-node reruns currently cover the rack-acceptance gate only. ## OpenAPI ````yaml /openapi/fleet-manager-openapi.yaml post /api/v1/burn-in/sites/{site_id}/rerun-plans/dispatch/ openapi: 3.0.3 info: title: Fleet Manager API version: 1.0.0 description: API for the Nscale Fleet Manager servers: [] security: [] paths: /api/v1/burn-in/sites/{site_id}/rerun-plans/dispatch/: post: tags: - Burn-in summary: Dispatch policy-aware burn-in reruns description: |- Calculate and dispatch safe reruns through the standard Job path. Multi-node reruns currently cover the rack-acceptance gate only. operationId: api_v1_burn_in_sites_rerun_plans_dispatch parameters: - in: path name: site_id schema: type: string format: uuid description: Site identifier. required: true requestBody: content: application/json: schema: $ref: '#/components/schemas/RerunPlanDispatchRequest' application/x-www-form-urlencoded: schema: $ref: '#/components/schemas/RerunPlanDispatchRequest' multipart/form-data: schema: $ref: '#/components/schemas/RerunPlanDispatchRequest' required: true responses: '200': content: application/json: schema: $ref: '#/components/schemas/RerunPlanDispatchResponse' description: '' '400': description: Device ids not part of the site. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '401': description: Authentication credentials were not provided or are invalid. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '403': description: You do not have permission to perform this action. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '404': description: Unknown site_id. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - oauth2: - job:create - cookieAuth: [] components: schemas: RerunPlanDispatchRequest: type: object description: Request body for live policy-aware rerun dispatch. properties: device_ids: type: array items: type: string format: uuid description: Devices at the site to re-plan and dispatch reruns for. minItems: 1 mode: allOf: - $ref: '#/components/schemas/RerunPlanningModeEnum' default: non_passing required: - device_ids RerunPlanDispatchResponse: type: object description: 'Dispatch outcome: created jobs plus grouped typed skips.' properties: created_jobs: type: array items: $ref: '#/components/schemas/DispatchedRerunJob' skips: type: array items: $ref: '#/components/schemas/RerunPlanSkipGroup' excluded_devices: type: array items: $ref: '#/components/schemas/RerunPlanExcludedDevice' required: - created_jobs - excluded_devices - skips ErrorResponse: type: object description: >- Uniform error body for every 4xx/5xx response. `detail` is a human-readable message, always present, safe to display to end users. `code` is the machine-readable identifier. `field_errors` lists per-input-field validation messages and is empty for non-field errors (auth, permission, not-found, conflict, server). required: - detail - code - field_errors properties: detail: type: string code: $ref: '#/components/schemas/ErrorCodeEnum' field_errors: type: array items: $ref: '#/components/schemas/FieldError' RerunPlanningModeEnum: enum: - non_passing - all type: string description: |- * `non_passing` - NON_PASSING * `all` - ALL DispatchedRerunJob: type: object description: One Job created from the live rerun calculation. properties: job_id: type: string format: uuid workflow_name: $ref: '#/components/schemas/RerunWorkflowNameEnum' topology: allOf: - $ref: '#/components/schemas/RerunPlanTopology' nullable: true description: Rack-acceptance topology identity; null for single-node jobs. device_ids: type: array items: type: string format: uuid required: - device_ids - job_id - topology - workflow_name RerunPlanSkipGroup: type: object description: >- Devices skipped for one topology, resource class, requirement, and reason. properties: device_ids: type: array items: type: string format: uuid minItems: 1 topology: allOf: - $ref: '#/components/schemas/RerunPlanTopology' nullable: true description: Rack-acceptance topology identity; null for single-node skips. resource_class: type: string requirement_name: type: string reason: $ref: '#/components/schemas/RerunPlanSkipReasonEnum' required: - device_ids - reason - requirement_name - resource_class - topology RerunPlanExcludedDevice: type: object description: One selected device excluded from planning entirely. properties: device_id: type: string format: uuid reason: $ref: '#/components/schemas/RerunPlanExcludedDeviceReasonEnum' required: - device_id - reason ErrorCodeEnum: type: string description: >- Stable machine-readable error identifier. New members may be added within this API version; clients must tolerate unknown values. enum: - error - invalid - parse_error - authentication_failed - not_authenticated - permission_denied - not_found - method_not_allowed - not_acceptable - unsupported_media_type - conflict - enrollment_infrastructure_reference_pending - enrollment_infrastructure_reference_changed - unprocessable_entity - throttled - service_unavailable FieldError: type: object description: One input field's validation messages. required: - field - messages properties: field: type: string description: >- Dotted path to the offending input field, or to the collection row when the whole row is invalid (e.g. `filters.end_date`, `memberships.0.role`, `memberships.0`). messages: type: array minItems: 1 items: type: string RerunWorkflowNameEnum: enum: - SingleNodeBurnInWorkflow - MultiNodeBurnInCollectiveWorkflow type: string description: |- * `SingleNodeBurnInWorkflow` - SINGLE_NODE * `MultiNodeBurnInCollectiveWorkflow` - MULTI_NODE_COLLECTIVE RerunPlanTopology: type: object description: Topology identity for one atomic rack-acceptance rerun cohort. properties: id: type: string format: uuid unit: $ref: '#/components/schemas/StandupTopologyUnitEnum' label: type: string required: - id - label - unit RerunPlanSkipReasonEnum: enum: - projection_pending - already_satisfied - no_policy_satisfying_parameter_source - policy_changed - workflow_unavailable - device_ineligible - device_contended - already_dispatched - topology_cohort_blocked type: string description: >- * `projection_pending` - PROJECTION_PENDING * `already_satisfied` - ALREADY_SATISFIED * `no_policy_satisfying_parameter_source` - NO_POLICY_SATISFYING_PARAMETER_SOURCE * `policy_changed` - POLICY_CHANGED * `workflow_unavailable` - WORKFLOW_UNAVAILABLE * `device_ineligible` - DEVICE_INELIGIBLE * `device_contended` - DEVICE_CONTENDED * `already_dispatched` - ALREADY_DISPATCHED * `topology_cohort_blocked` - TOPOLOGY_COHORT_BLOCKED RerunPlanExcludedDeviceReasonEnum: enum: - no_acceptance_policy - no_single_node_requirements - no_rerun_requirements type: string description: |- * `no_acceptance_policy` - NO_ACCEPTANCE_POLICY * `no_single_node_requirements` - NO_SINGLE_NODE_REQUIREMENTS * `no_rerun_requirements` - NO_RERUN_REQUIREMENTS StandupTopologyUnitEnum: enum: - nvlink-domain - pod - rack type: string description: |- * `nvlink-domain` - NVLINK_DOMAIN * `pod` - POD * `rack` - RACK securitySchemes: oauth2: type: oauth2 flows: {} cookieAuth: type: apiKey in: cookie name: sessionid ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.