Redrive a failed scoped occurrence

POST

/v1/pilot/runs/{pipelineId}/redrive

• The private service origin. Reachable only over a Cloudflare service binding from within the account — not from the public internet, and not from a browser. No public base URL is assigned yet; when one is, it replaces this entry.

Requires sync:write. The body is exactly an empty object. Current schedule and grant authority must still permit work. The failed phase gets a fresh bounded attempt budget; the pipeline, source run, destination ordinal and any immutable export evidence are retained. The authenticated API key ID is recorded as actor; no caller-supplied actor is accepted. Implemented and locally tested; new live scheduled delivery and controlled failure/recovery acceptance remain pending.

Authorizations

• bearerAuth

Parameters

Path Parameters

pipelineId

required

string

/^[A-Za-z0-9_-]{1,128}$/

Request Body ^required

object

Responses

200

Redrive a failed scoped occurrence.

object

pipelineId

required

string

/^[A-Za-z0-9_-]{1,128}$/

phase

required

string

Allowed values: source export

400

invalid_json or invalid_request for a query delimiter or a non-empty body.

object

error

required

object

code

required

string

Allowed values: invalid_request invalid_json invalid_schedule unsupported_media_type unsupported_encoding request_too_large unauthorized forbidden not_found method_not_allowed destination_not_found schedule_not_found pipeline_not_found connection_unavailable source_permission_required destination_permission_required schedule_enable_forbidden schedule_inactive destination_conflict destination_creation_unconfirmed destination_unavailable timezone_unverified timezone_conflict schedule_conflict redrive_conflict sheet_capacity_exhausted sheet_layout_conflict credential_configuration_unavailable automation_configuration_unavailable credential_unavailable credential_busy provider_auth_failed provider_rate_limited provider_unavailable automation_unavailable

message

required

string

error

object

code

Allowed values: invalid_request invalid_json invalid_schedule

error

object

code

Allowed values: invalid_request invalid_json unauthorized forbidden source_permission_required destination_permission_required schedule_inactive pipeline_not_found method_not_allowed redrive_conflict request_too_large unsupported_media_type unsupported_encoding automation_configuration_unavailable credential_configuration_unavailable automation_unavailable

401

Missing, expired, revoked or reassigned key, including changes before response release.

object

error

required

object

code

required

string

Allowed values: invalid_request invalid_json invalid_schedule unsupported_media_type unsupported_encoding request_too_large unauthorized forbidden not_found method_not_allowed destination_not_found schedule_not_found pipeline_not_found connection_unavailable source_permission_required destination_permission_required schedule_enable_forbidden schedule_inactive destination_conflict destination_creation_unconfirmed destination_unavailable timezone_unverified timezone_conflict schedule_conflict redrive_conflict sheet_capacity_exhausted sheet_layout_conflict credential_configuration_unavailable automation_configuration_unavailable credential_unavailable credential_busy provider_auth_failed provider_rate_limited provider_unavailable automation_unavailable

message

required

string

error

object

code

Allowed value: unauthorized

error

object

code

Allowed values: invalid_request invalid_json unauthorized forbidden source_permission_required destination_permission_required schedule_inactive pipeline_not_found method_not_allowed redrive_conflict request_too_large unsupported_media_type unsupported_encoding automation_configuration_unavailable credential_configuration_unavailable automation_unavailable

Headers

WWW-Authenticate

required

string

Allowed value: Bearer

403

forbidden, source_permission_required, destination_permission_required, or schedule_inactive.

object

error

required

object

code

required

string

Allowed values: invalid_request invalid_json invalid_schedule unsupported_media_type unsupported_encoding request_too_large unauthorized forbidden not_found method_not_allowed destination_not_found schedule_not_found pipeline_not_found connection_unavailable source_permission_required destination_permission_required schedule_enable_forbidden schedule_inactive destination_conflict destination_creation_unconfirmed destination_unavailable timezone_unverified timezone_conflict schedule_conflict redrive_conflict sheet_capacity_exhausted sheet_layout_conflict credential_configuration_unavailable automation_configuration_unavailable credential_unavailable credential_busy provider_auth_failed provider_rate_limited provider_unavailable automation_unavailable

message

required

string

error

object

code

Allowed values: forbidden source_permission_required destination_permission_required schedule_enable_forbidden schedule_inactive

error

object

code

Allowed values: invalid_request invalid_json unauthorized forbidden source_permission_required destination_permission_required schedule_inactive pipeline_not_found method_not_allowed redrive_conflict request_too_large unsupported_media_type unsupported_encoding automation_configuration_unavailable credential_configuration_unavailable automation_unavailable

404

pipeline_not_found in this workspace.

object

error

required

object

code

required

string

Allowed values: invalid_request invalid_json invalid_schedule unsupported_media_type unsupported_encoding request_too_large unauthorized forbidden not_found method_not_allowed destination_not_found schedule_not_found pipeline_not_found connection_unavailable source_permission_required destination_permission_required schedule_enable_forbidden schedule_inactive destination_conflict destination_creation_unconfirmed destination_unavailable timezone_unverified timezone_conflict schedule_conflict redrive_conflict sheet_capacity_exhausted sheet_layout_conflict credential_configuration_unavailable automation_configuration_unavailable credential_unavailable credential_busy provider_auth_failed provider_rate_limited provider_unavailable automation_unavailable

message

required

string

error

object

code

Allowed values: not_found destination_not_found schedule_not_found pipeline_not_found connection_unavailable

error

object

code

Allowed values: invalid_request invalid_json unauthorized forbidden source_permission_required destination_permission_required schedule_inactive pipeline_not_found method_not_allowed redrive_conflict request_too_large unsupported_media_type unsupported_encoding automation_configuration_unavailable credential_configuration_unavailable automation_unavailable

405

method_not_allowed — use the method named in Allow.

object

error

required

object

code

required

string

Allowed values: invalid_request invalid_json invalid_schedule unsupported_media_type unsupported_encoding request_too_large unauthorized forbidden not_found method_not_allowed destination_not_found schedule_not_found pipeline_not_found connection_unavailable source_permission_required destination_permission_required schedule_enable_forbidden schedule_inactive destination_conflict destination_creation_unconfirmed destination_unavailable timezone_unverified timezone_conflict schedule_conflict redrive_conflict sheet_capacity_exhausted sheet_layout_conflict credential_configuration_unavailable automation_configuration_unavailable credential_unavailable credential_busy provider_auth_failed provider_rate_limited provider_unavailable automation_unavailable

message

required

string

error

object

code

Allowed value: method_not_allowed

error

object

code

Allowed values: invalid_request invalid_json unauthorized forbidden source_permission_required destination_permission_required schedule_inactive pipeline_not_found method_not_allowed redrive_conflict request_too_large unsupported_media_type unsupported_encoding automation_configuration_unavailable credential_configuration_unavailable automation_unavailable

Headers

Allow

required

string

Allowed value: POST

409

redrive_conflict — the owned occurrence is not currently redrivable.

object

error

required

object

code

required

string

Allowed values: invalid_request invalid_json invalid_schedule unsupported_media_type unsupported_encoding request_too_large unauthorized forbidden not_found method_not_allowed destination_not_found schedule_not_found pipeline_not_found connection_unavailable source_permission_required destination_permission_required schedule_enable_forbidden schedule_inactive destination_conflict destination_creation_unconfirmed destination_unavailable timezone_unverified timezone_conflict schedule_conflict redrive_conflict sheet_capacity_exhausted sheet_layout_conflict credential_configuration_unavailable automation_configuration_unavailable credential_unavailable credential_busy provider_auth_failed provider_rate_limited provider_unavailable automation_unavailable

message

required

string

error

object

code

Allowed values: destination_conflict destination_creation_unconfirmed destination_unavailable timezone_unverified timezone_conflict schedule_conflict redrive_conflict sheet_capacity_exhausted sheet_layout_conflict

error

object

code

Allowed values: invalid_request invalid_json unauthorized forbidden source_permission_required destination_permission_required schedule_inactive pipeline_not_found method_not_allowed redrive_conflict request_too_large unsupported_media_type unsupported_encoding automation_configuration_unavailable credential_configuration_unavailable automation_unavailable

413

Request JSON exceeds 4096 bytes.

object

error

required

object

code

required

string

Allowed values: invalid_request invalid_json invalid_schedule unsupported_media_type unsupported_encoding request_too_large unauthorized forbidden not_found method_not_allowed destination_not_found schedule_not_found pipeline_not_found connection_unavailable source_permission_required destination_permission_required schedule_enable_forbidden schedule_inactive destination_conflict destination_creation_unconfirmed destination_unavailable timezone_unverified timezone_conflict schedule_conflict redrive_conflict sheet_capacity_exhausted sheet_layout_conflict credential_configuration_unavailable automation_configuration_unavailable credential_unavailable credential_busy provider_auth_failed provider_rate_limited provider_unavailable automation_unavailable

message

required

string

error

object

code

Allowed value: request_too_large

error

object

code

Allowed values: invalid_request invalid_json unauthorized forbidden source_permission_required destination_permission_required schedule_inactive pipeline_not_found method_not_allowed redrive_conflict request_too_large unsupported_media_type unsupported_encoding automation_configuration_unavailable credential_configuration_unavailable automation_unavailable

415

Use application/json with no Content-Encoding other than identity.

object

error

required

object

code

required

string

Allowed values: invalid_request invalid_json invalid_schedule unsupported_media_type unsupported_encoding request_too_large unauthorized forbidden not_found method_not_allowed destination_not_found schedule_not_found pipeline_not_found connection_unavailable source_permission_required destination_permission_required schedule_enable_forbidden schedule_inactive destination_conflict destination_creation_unconfirmed destination_unavailable timezone_unverified timezone_conflict schedule_conflict redrive_conflict sheet_capacity_exhausted sheet_layout_conflict credential_configuration_unavailable automation_configuration_unavailable credential_unavailable credential_busy provider_auth_failed provider_rate_limited provider_unavailable automation_unavailable

message

required

string

error

object

code

Allowed values: unsupported_media_type unsupported_encoding

error

object

code

Allowed values: invalid_request invalid_json unauthorized forbidden source_permission_required destination_permission_required schedule_inactive pipeline_not_found method_not_allowed redrive_conflict request_too_large unsupported_media_type unsupported_encoding automation_configuration_unavailable credential_configuration_unavailable automation_unavailable

503

automation_configuration_unavailable, credential_configuration_unavailable, or automation_unavailable.

object

error

required

object

code

required

string

Allowed values: invalid_request invalid_json invalid_schedule unsupported_media_type unsupported_encoding request_too_large unauthorized forbidden not_found method_not_allowed destination_not_found schedule_not_found pipeline_not_found connection_unavailable source_permission_required destination_permission_required schedule_enable_forbidden schedule_inactive destination_conflict destination_creation_unconfirmed destination_unavailable timezone_unverified timezone_conflict schedule_conflict redrive_conflict sheet_capacity_exhausted sheet_layout_conflict credential_configuration_unavailable automation_configuration_unavailable credential_unavailable credential_busy provider_auth_failed provider_rate_limited provider_unavailable automation_unavailable

message

required

string

error

object

code

Allowed values: credential_configuration_unavailable automation_configuration_unavailable credential_unavailable credential_busy provider_rate_limited automation_unavailable

error

object

code

Allowed values: invalid_request invalid_json unauthorized forbidden source_permission_required destination_permission_required schedule_inactive pipeline_not_found method_not_allowed redrive_conflict request_too_large unsupported_media_type unsupported_encoding automation_configuration_unavailable credential_configuration_unavailable automation_unavailable