MCPBundler Docs
MCPBundler Docs
Back to marketplaceGetting StartedAuthenticationTutorial - Bundle to Connected Agent
API Reference
Agent A2A Tools
Agent Channels
Agent Configuration (Staging)
Agent Configuration (Versions)
Agent Tools
Agents
Auth
Billing
Bundler
Append Conversation Messages (M2M)Append Workflow Run Trace Step (M2M, fail-open)Create Conversation (M2M)Create Workflow Run (M2M)Dispatch a Matched Tool-Call Webhook (M2M)Finalize Workflow Run Outputs (M2M, fail-closed on the caller's side)Ingest Request TelemetryResolve An SMS Conversation Thread (M2M)Mint Widget Session Token (M2M)Reconcile Token LedgerReport An Outbound Call Outcome (M2M)Resolve Agent (M2M)Resolve Agent Config Snapshot (M2M)Resolve Agent for Inbound A2A (M2M, conditionally authenticated)Resolve BundleResolve Inbound Channel (M2M)Resolve LLM Credential (M2M)Resolve Telephony Credential For Outbound Origination (M2M)Resolve Tool-Call Override Bindings (M2M)Resolve Tool-Call Webhook Bindings (M2M)Resolve Public Widget Embed Key (M2M)Resolve Agent Workflow (M2M)Search Agent Knowledge Bases (M2M)Store Workflow Node Samples (M2M, fail-open)Submit Conversation Extraction (M2M)Update Conversation Status (M2M)Record Channel Status (M2M)
Bundler Tool
Bundles
Call Campaigns
Catalog
Conversations
Credentials
Deployments
Discover
Embedding
Fleet
Knowledge Bases
LLM
MCP Listings
Media
OAuth Clients
OAuth2
Observability
Organisations
Realtime
Reviews
Roadmap
SCIM
STT
Suppression
Triggers
TTS
Users
Utils
Voices
Webhooks
Workflows
API ReferenceBundler

Create Workflow Run (M2M)

POST
/v1/bundler/workflow-runs

Create the WorkflowRun record for a conversation that is starting. Exactly one of workflow_version_id (the saved-but-not-live version override path) and agent_config_version_id (every ordinary run) must be given. Authenticated with a BundleAccessToken for the SAME deployment the target Conversation belongs to. Retrying after a timeout returns the existing run for the same conversation and version rather than erroring.

Authorization

BundleAccessToken
AuthorizationBearer <token>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Exactly one of the two version fields must be set - 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.

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"}
Empty
Empty
Empty

Create Conversation (M2M)

Previous Page

Dispatch a Matched Tool-Call Webhook (M2M)

Next Page

conversation_id*Conversation Id
Formatuuid
workflow_version_id?|null
agent_config_version_id?|null