Sign in

v1

latestOpenAPI 3.1.0Apache-2.02026-07-226091175.5 KB
Runs

Start a run

Start a run. Send JSON or multipart/form-data.

post/api/v1/runs

Query parameters

versionstring

Release or git ref. Defaults to latest.

Release or git ref. Defaults to latest.

wait_for_completioninteger

Seconds to wait before returning (max 600). Omit for async.

Seconds to wait before returning (max 600). Omit for async.

Request body

targetstring required

Automation target without a version suffix, e.g. workflows.invoice or agents.support.

inputobject

Scalar and structured automation arguments.

filesobject

File inputs as ingress references ({ "$fileId": "file_..." } or { "$inline": { filename, mimeType, base64 } }). Upload bytes via multipart files.<fieldName> parts instead.

metadataobject

Caller-supplied run metadata.

Response

Run completed while waiting — same body as GET /api/v1/runs/:id

OR