Run a workflow
Runs a workflow version. ?version=active (default), draft, or v{n}. Body: { input, groupId?, groupName?, runtimeAuth? } — input is the workflow input, groupId/groupName select the chatter group whose Requesty key bills the agent steps (like /v1/chat), and runtimeAuth supplies per-request credentials for tool steps (custom + MCP). Drafts are validated at run time and rejected with 422 if invalid. Identity is header-borne: Authorization, X-Organization-Id, and X-User-Id.
Authorizations
Org API key (scopes the request to its organization) or the shared trusted key (requires X-Organization-Id on every request).
Headers
Organization to scope the request to. Optional when authenticating with an org API key (the org is taken from the key; if sent, it must match). Required when authenticating with the trusted key.
End-user identity for the request; user-scoped data (threads, memory) resolves to {orgId}_{userId}. Required by endpoints that read or write user-scoped resources. A userId query param (or body field, where documented) is accepted as a fallback.
Path Parameters
Query Parameters
active (default) | draft | v{n}
Body
The workflow input (validated against the version's input schema by the run)
Optional STABLE caller-supplied chatter group id (chatter_groups.external_id). When sent, group matching is by this id; a differing groupName renames the group.
1 - 255Optional chatter group name. Without groupId this matches/provisions by name (legacy behavior); alongside groupId it is display-only (rename on change).
Runtime authentication map: { [providerNameOrId]: { credentials } } — used by tool steps (custom + MCP)
Response
Run completed