Skip to main content
POST
Start one workflow run

Authorizations

x-api-key
string
header
required

Organization API key. Get it from the 11x team or from the platform.

Headers

Idempotency-Key
string

Unique per organization and agent while the run remains queryable. Reusing it with a different body returns 422.

Required string length: 1 - 255

Path Parameters

agentId
string
required

ID of the agent, e.g. agent.abc123.

Body

application/json

Fields and required keys depend on the published Start API request schema. Field names use lower camelCase or snake_case, begin with a lowercase letter, contain at most 64 characters, and are unique regardless of case.

{key}

Response

Run admitted and queued.

workflowRunId
string
required