/
DE
desplega-ai
/
Agent Swarm API
Search skmtc…
⌘K
Docs
Sign in
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Sources
Checked 2h ago · Updated 23h ago
View markdown
desplega-ai
Agent Swarm API
post
Trigger a workflow execution
v
latest
OpenAPI 3.1.0
raw.githubusercontent.com
2026-08-08
347
69
1.3 MB
Active Sessions
8
Agents
12
API Keys
8
ApprovalRequests
4
Apps
20
Assets
6
Budgets
5
Config
7
Debug
1
Ecosystem
1
Events
4
External APIs
1
Favorites
2
FS
9
Heartbeat
2
Inbox State
2
Integrations
2
KV
10
MCP OAuth
8
MCP Servers
8
Memory
12
Metrics
9
OAuth
6
Pages
17
Poll
2
Pricing
6
PromptTemplates
10
Repos
5
Schedules
7
Script Connections
21
Script Runs
10
Scripts
16
Session Data
6
Sessions
2
Skills
17
Stats
6
Status
2
Task Templates
1
Tasks
21
Trackers
14
Users
13
Webhooks
5
WorkflowEvents
2
Workflows
17
get
List all workflows
post
Create a new workflow
get
Get a workflow by ID
put
Update a workflow
delete
Delete a workflow
patch
Patch a workflow definition (create/update/delete nodes)
patch
Patch a single node in a workflow definition
post
Trigger a workflow execution
post
Validate a payload against the workflow's triggerSchema (no run)
get
List runs for a workflow
get
Get a workflow run with steps (includes retry columns)
post
Retry a failed workflow run
post
Cancel a running or waiting workflow run
get
List all executor types with their config and output schemas
get
Get a specific executor type with its schemas
get
List version history for a workflow
get
Get a specific version snapshot of a workflow
Workflows
Trigger a workflow execution
post
/api/workflows/{id}/trigger
Path parameters
id
string
required
Response
Workflow run started (or skipped if cooldown active)
object
required
runId
string
required
skipped
boolean
required