Create Run
Start an asynchronous workflow run. Returns 202 Accepted with a run id and polling URLs.
curl -X POST 'https://api.edgaze.ai/v1/runs' \
-H 'Authorization: Bearer edgaze_sk_live_YOUR_KEY' \
-H 'Content-Type: application/json' \
-d '{"workflow":"550e8400-e29b-41d4-a716-446655440000","inputs":{"topic":"AI agents in production"}}'https://api.edgaze.ai/v1/runsOverview#
This is the primary execution endpoint. It accepts a workflow id and an inputs object, validates entitlement and spend caps synchronously, then returns 202 Accepted with a run id and URLs for polling.
Runs are asynchronous. A successful response means the run was queued, not finished. Always follow `statusUrl` until the run reaches a terminal state, then read outputs from the same response or from GET /runs/{id}/events for step-level progress.
Authorization#
Requires `run:execute`.
run:executeParameters#
Headers
AuthorizationstringheaderrequiredBearer token with run:execute scope.
Example: Bearer edgaze_sk_live_…
Request body
workflowstringbodyrequiredWorkflow UUID. Alias: workflowId.
Example: 550e8400-e29b-41d4-a716-446655440000
inputsobjectbodyrequiredMap of input field names (or nodeIds) to values matching the workflow inputSchema.
Example: {"topic": "AI agents", "tone": "Technical"}
idempotencyKeystringbodyOptional idempotency key to safely retry run creation.
Response#
Only POST /runs is rate-limited (60 req/min per key). Invalid JSON returns 400 `invalid_json`. Missing workflow returns 400 `missing_workflow`.
Example payloads are in the request/response panel above.
Edge cases#
POST returns 202 before wallet funding is verified. If balance is insufficient, the run fails asynchronously. Poll GET /runs/{id} and check for status failed.
spend_cap_reachedSpend cap checks happen before the run row is created. A cap breach returns 402 immediately with no run ID.
rate_limitedRate limiting is enforced before run execution. A 429 never creates a partial run.
API runs use identical entitlement, wallet, bundle, and BYOK billing paths as runs started from the web app.