> ## Documentation Index > Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt > Use this file to discover all available pages before exploring further. # Rerun a backfill against its failed tickets > Spawn a new backfill scoped to the source's failed entities. The new backfill inherits the source's target workflow, execution windows, timezone, and concurrency cap; only the tickets that failed in the source are dispatched (no PSA filter re-evaluation). Eligibility: source state is terminal (Completed / Cancelled / Failed), `failed_count > 0`, and no active backfill exists for the same target workflow — otherwise `409 backfill_not_rerunnable` (or `409 backfill_already_active` for the conflict case). Returns 201 with the new backfill + cost estimate (credits). ## OpenAPI ````yaml https://api.neoagent.io/public-api/openapi.json post /public-api/backfills/{backfill_id}/rerun-failed openapi: 3.1.0 info: description: >- Neo's public contract for the dashboard ChatAgent, partner integrations, and MSP automation. Every response is wrapped in a `{data, meta}` envelope; errors use `{error: {code, message, details?}, meta: {request_id}}`. Authenticate with a `Bearer neo_sk__` API key (service account) or a Microsoft Entra ID JWT (dashboard user). Signed-URL endpoints (end-user feedback links) take a `signature` query parameter instead. title: Neo Public API version: 1.0.0 servers: - url: https://api.neoagent.io security: [] tags: - description: Service metadata — health, OpenAPI. name: Meta - description: Agents and workflows — read, version history, delete, stats. name: Agents - description: Agent/workflow execution history, sub-resources, retry/cancel. name: Executions - description: PSA webhook events and their workflow-match results. name: Callbacks - description: Technician-in-the-loop approval requests. name: TIL requests - description: RMM script executions triggered by agents. name: RMM scripts - description: Dispatch-agent field-update decisions. name: Dispatch - description: The authenticated tenant. name: Tenant - description: Agent-builder schema catalogs (raw JSON payloads). name: Schemas - description: Escalate to the Neo team (HubSpot ticket). name: Escalation - description: Tenant settings. name: Settings - description: Tenant API-key management (dashboard JWT only). name: API keys - description: End-user feedback links (signed-URL auth). name: Feedback - description: End-client companies (CRUD + bulk-update). name: End companies - description: Channels — bind a CONVERSATIONAL agent to a transport (Teams). name: Channels - description: PSA/RMM/M365 integration status and connection management. name: Integrations - description: Technician roster (controls TIL routing and paging). name: Technicians - description: Future runs queued for TRIGGERED agents. name: Scheduled work - description: Subscription state and customer-facing credit usage (no provider $). name: Billing - description: Inbox messages and announcements. name: Inbox & Comms - description: Tenant-authored agent skills (CRUD) and the built-in skill catalog. name: Skills paths: /public-api/backfills/{backfill_id}/rerun-failed: post: tags: - Backfills summary: Rerun a backfill against its failed tickets description: >- Spawn a new backfill scoped to the source's failed entities. The new backfill inherits the source's target workflow, execution windows, timezone, and concurrency cap; only the tickets that failed in the source are dispatched (no PSA filter re-evaluation). Eligibility: source state is terminal (Completed / Cancelled / Failed), `failed_count > 0`, and no active backfill exists for the same target workflow — otherwise `409 backfill_not_rerunnable` (or `409 backfill_already_active` for the conflict case). Returns 201 with the new backfill + cost estimate (credits). operationId: public_api.backfills_rerun_failed_post parameters: - in: path name: backfill_id required: true schema: type: string responses: '201': content: application/json: schema: properties: data: $ref: '#/components/schemas/CreateBackfillResponse' meta: $ref: '#/components/schemas/SuccessMeta' required: - data - meta type: object description: Success. '400': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Bad request — malformed input. '401': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Unauthenticated — missing or invalid credentials. '403': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Forbidden — authenticated but not allowed. '404': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Not found. '409': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Conflict — the resource is in a state that blocks this operation. '422': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Request validation failed. '429': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Rate limited — see Retry-After. '500': content: application/json: schema: $ref: '#/components/schemas/ErrorEnvelope' description: Internal server error. security: - bearerAuth: [] components: schemas: CreateBackfillResponse: properties: backfill: $ref: '#/components/schemas/PublicBackfill' cost_estimate: $ref: '#/components/schemas/BackfillCostEstimate' required: - backfill - cost_estimate title: CreateBackfillResponse type: object SuccessMeta: properties: pagination: $ref: '#/components/schemas/Pagination' request_id: format: uuid type: string timings_ms: additionalProperties: type: number type: object warnings: description: >- Non-fatal warnings about the created/updated resource (e.g. an unhealthy PSA callback). items: type: string type: array required: - request_id - timings_ms type: object ErrorEnvelope: properties: error: properties: code: description: Stable machine-readable error code. type: string details: additionalProperties: true type: object message: type: string required: - code - message type: object meta: properties: request_id: format: uuid type: - string - 'null' type: object required: - error - meta type: object PublicBackfill: description: >- One backfill row, as exposed on the public API. Naming: stays `backfill` everywhere — unlike the agent/workflow rename for `workflows_v2`, backfills are user-facing under their internal name. Surfacing-only fields (`target_workflow_name`, `autonomy_type`) appear so callers can render a meaningful label without a second fetch. properties: completed_at: anyOf: - type: string - type: 'null' title: Completed At created_at: title: Created At type: string created_by: title: Created By type: string daily_execution_windows: $ref: '#/components/schemas/WorkflowDailyExecutionWindows' entity_type: $ref: '#/components/schemas/EntityType' error: anyOf: - type: string - type: 'null' title: Error failed_count: title: Failed Count type: integer filter_spec: additionalProperties: true title: Filter Spec type: object id: title: Id type: string max_in_flight: title: Max In Flight type: integer parent_backfill_run_id: anyOf: - type: string - type: 'null' default: null title: Parent Backfill Run Id processed_count: title: Processed Count type: integer started_at: anyOf: - type: string - type: 'null' title: Started At state: $ref: '#/components/schemas/BackfillRunState' succeeded_count: title: Succeeded Count type: integer target_workflow_autonomy_type: anyOf: - $ref: '#/components/schemas/AutonomyType' - type: 'null' target_workflow_id: title: Target Workflow Id type: integer target_workflow_name: anyOf: - type: string - type: 'null' title: Target Workflow Name timezone: title: Timezone type: string total_estimated: anyOf: - type: integer - type: 'null' title: Total Estimated required: - id - state - target_workflow_id - target_workflow_name - target_workflow_autonomy_type - entity_type - filter_spec - daily_execution_windows - timezone - max_in_flight - total_estimated - processed_count - succeeded_count - failed_count - started_at - completed_at - created_by - created_at - error title: PublicBackfill type: object BackfillCostEstimate: description: |- The customer-facing cost ceiling shown alongside a created backfill. Credit-denominated, never $/token — provider cost details never leave the public API surface (spec §6). properties: credits_per_entity: title: Credits Per Entity type: integer total_credits_estimated: title: Total Credits Estimated type: integer total_entities: title: Total Entities type: integer required: - total_entities - credits_per_entity - total_credits_estimated title: BackfillCostEstimate type: object Pagination: properties: has_more: type: boolean next_cursor: type: - string - 'null' required: - next_cursor - has_more type: object WorkflowDailyExecutionWindows: properties: friday: items: $ref: '#/components/schemas/WorkflowTimeWindow' title: Friday type: array monday: items: $ref: '#/components/schemas/WorkflowTimeWindow' title: Monday type: array saturday: items: $ref: '#/components/schemas/WorkflowTimeWindow' title: Saturday type: array sunday: items: $ref: '#/components/schemas/WorkflowTimeWindow' title: Sunday type: array thursday: items: $ref: '#/components/schemas/WorkflowTimeWindow' title: Thursday type: array tuesday: items: $ref: '#/components/schemas/WorkflowTimeWindow' title: Tuesday type: array wednesday: items: $ref: '#/components/schemas/WorkflowTimeWindow' title: Wednesday type: array title: WorkflowDailyExecutionWindows type: object EntityType: enum: - ticket - project_ticket - task - scheduled_entry - time_entry - project - company - contact - resource - contract - opportunity - none - configuration - note - team - role - audit_trail - appointment - servicecall - contract_service - company_location - product title: EntityType type: string BackfillRunState: enum: - DRAFT - RUNNING - PAUSED - COMPLETED - CANCELLED - FAILED title: BackfillRunState type: string AutonomyType: enum: - CHAINED_ACTIONS - AGENTIC - CONVERSATIONAL title: AutonomyType type: string WorkflowTimeWindow: properties: run_end_time: format: time title: Run End Time type: string run_start_time: format: time title: Run Start Time type: string required: - run_start_time - run_end_time title: WorkflowTimeWindow type: object securitySchemes: bearerAuth: description: >- `Authorization: Bearer ` where `` is either a `neo_sk__` API key (service account) or a Microsoft Entra ID access token (dashboard user). scheme: bearer type: http ````