Create Workflow Run (M2M)
Create the WorkflowRun record for a conversation that is starting. At most one of workflow_version_id (the saved-but-not-live version override path) and agent_config_version_id (every ordinary run) may be given; a staged preview gives neither and must send definition, which every run may send to record the graph it executes. Authenticated with a run or deployment token whose scope covers the target Conversation. Retrying after a timeout returns the existing run for the same conversation and version rather than erroring.
Authorization
BundleAccessToken In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
At most one of the two version fields may be set, and a run with neither (a staged preview) must carry its definition - validated in the route rather than here, so the rejection is a plain 422 naming the rule instead of a pydantic field error on a model with no single offending field. See WorkflowResolveOut above for what each means.
definition is the graph the run executes, recorded on every run that sends it so the run stays inspectable after later edits.
Response Body
application/json
curl -X POST "https://example.com/v1/bundler/workflow-runs" \ -H "Content-Type: application/json" \ -d '{ "conversation_id": "cc71b11a-25cd-4c2d-9950-df2cc38e3407" }'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08"}