curl --request POST \
--url https://julian.11x.ai/api/v1/workflows/{agentId}/run \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"contact_name": "Example Person",
"priority": 2
}
'import requests
url = "https://julian.11x.ai/api/v1/workflows/{agentId}/run"
payload = {
"contact_name": "Example Person",
"priority": 2
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({contact_name: 'Example Person', priority: 2})
};
fetch('https://julian.11x.ai/api/v1/workflows/{agentId}/run', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"workflowRunId": "wf-run.example"
}Start one workflow run
Starts the enabled published API-triggered workflow for this agent. The request body is a flat object of at most 50 configured scalar fields; unknown fields, objects and arrays are rejected. The published schema controls validation. The organization x-api-key is sufficient; HMAC signing is not required on this route. A successful response contains a durable run ID that can be read immediately, even while queued. Reuse an optional Idempotency-Key with an unchanged body to recover the same run; omit it for a distinct run each time.
curl --request POST \
--url https://julian.11x.ai/api/v1/workflows/{agentId}/run \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"contact_name": "Example Person",
"priority": 2
}
'import requests
url = "https://julian.11x.ai/api/v1/workflows/{agentId}/run"
payload = {
"contact_name": "Example Person",
"priority": 2
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({contact_name: 'Example Person', priority: 2})
};
fetch('https://julian.11x.ai/api/v1/workflows/{agentId}/run', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"workflowRunId": "wf-run.example"
}Authorizations
Organization API key. Get it from the 11x team or from the platform.
Headers
Unique per organization and agent while the run remains queryable. Reusing it with a different body returns 422.
1 - 255Path Parameters
ID of the agent, e.g. agent.abc123.
Body
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.
Response
Run admitted and queued.