Skip to main content
POST
Submit a job

Authorizations

Authorization
string
header
required

Your secret key as a bearer token, e.g. Authorization: Bearer sk_live_…. Secret keys are server-side only.

Body

application/json

Canonical job submission. Each entry in sources[] is a single source file plus the ordered steps[] to run on it. Step types compatible with the source's auto-detected fileType are kept; incompatible steps are recorded as skipped in the audit log. Async (201) by default; set sync: true to wait up to ~27 s for completion (200) or 202 + pending: true on timeout. An optional webhook is called when the job reaches a terminal status regardless of sync mode.

sources
any[]
required

List of source files to process. Each becomes its own Task under a single Job.

Required array length: 1 - 50 elements
ruleId
string

Optional Rule id (rule_xxx) recorded on the Job for downstream routing/reporting. Not consumed by the pipeline itself.

channel
enum<string>
default:api
Available options:
api,
store,
admin
customerId
string | null
orderId
string | null
policy
object
sync
boolean
default:false

When true, wait up to ~27 s for the job to reach a terminal status. Returns 200 with { job } on completion or 202 with pending: true on timeout. Default false (async 201).

webhook
any
metaData
any

Response

Sync completion (sync: true)

job
object