EndpointsFast-forward source

Fast-forward source

Updates target source with new data from a temporary source (URL, CONTENT, or FILE). Target source must exist and be in final status (COMPLETED or FAILED). Creates temp source, uploads initial_data, and triggers fast-forward workflow.

curl -X POST "//v1/sources/example_string/fast-forward" \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_TOKEN (API Key)" \
  -d '{
  "type": "URI",
  "initial_data": {
    "url": "example_string",
    "uri": "example_string",
    "source_ids": [
      "example_string"
    ],
    "data": "example_string"
  },
  "instructions": {}
}'
{}
POST
/v1/sources/{sourceId}/fast-forward
POST
Bearer Token (API Key)
Bearer Tokenstring
Required

User API Key. Create in the Ctxfy dashboard or via POST /v1/api-keys. Use Bearer <api_key> in Authorization header.

User API Key. Create in the Ctxfy dashboard or via POST /v1/api-keys. Use Bearer <api_key> in Authorization header.
Content-Typestring
Required

The media type of the request body

Options: application/json
typestring
Required

Type of new source data

Options: URI, FILE, CONTENT
initial_dataobject
Required

URI: url or uri required. COMPOSITION: source_ids required. FILE: data with fileKey from S3 presign response. CONTENT: data with inline content.

instructionsobject

Optional processing instructions

Request Preview
Response

Response will appear here after sending the request

Authentication

header
Authorizationstring
Required

Bearer token (API Key). User API Key. Create in the Ctxfy dashboard or via POST /v1/api-keys. Use Bearer <api_key> in Authorization header.

Path Parameters

Body

application/json
typestring
Required

Type of new source data

Allowed values:URIFILECONTENT
initial_dataobject
Required

URI: url or uri required. COMPOSITION: source_ids required. FILE: data with fileKey from S3 presign response. CONTENT: data with inline content.

instructionsobject

Optional processing instructions

Responses

Fast-forward initiated