Skip to main content
POST
cURL

Authorizations

Authorization
string
header
required

Hiloop API key sent as an HTTP Bearer token.

Headers

idempotency-key
string

Optional idempotency key for this mutation. The server records the result from execution start. For at least 72 hours, reuse by the same organization and route replays the original status and body. A matching request still in flight or reuse for different input returns 409 idempotency_conflict. Keys are scoped by organization and route and contain 1-255 characters.

Required string length: 1 - 255

Body

application/json
project_id
string

The project the new run belongs to.

parent_run_id
string

Optional parent run to continue the tree from. Empty starts a new tree root.

label
string

An optional human-readable label.

execute_as_workload
string

Optional registered workload name to run as. When set, the run is attributed to that workload (the caller must hold launch rights on it and the name must be registered); when empty, the run executes as the caller's own identity. The executing identity is always declared here, never inferred from the command.

Response

OK

run
object

The newly started run, with its lineage fields resolved.