/
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 22h ago
View markdown
desplega-ai
Agent Swarm API
post
Promote an undeliverable steering message
OpenAPI 3.1.0
raw.githubusercontent.com
2026-08-09
347
69
1.3 MB
db1079e034dc
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
get
Get context usage history for a task
post
Record a context usage snapshot for a task
get
List tasks with filters
post
Create a new task
put
Update provider session ID and harness metadata for a task
post
Cancel a pending or in-progress task
post
Deliver a steering message to a running task
get
List steering messages for a task
get
List pending steering messages for the current worker
post
Mark a steering message delivered
post
Mark a steering message handled
post
Promote an undeliverable steering message
get
Get task details with logs and attachments
post
Update task progress text
post
Mark task as completed or failed (runner endpoint)
get
Get paused tasks for this agent
post
Pause an in-progress task
post
Resume a paused task
post
Supersede an in-progress task (terminate + spawn resume follow-up)
patch
Update VCS (PR/MR) info for a task
patch
Set or clear a task's display title (session rename)
Trackers
14
Users
13
Webhooks
5
WorkflowEvents
2
Workflows
17
Tasks
Promote an undeliverable steering message
post
/api/steering-messages/{id}/undeliverable
Path parameters
id
string
required
Request body
object
required
reason
string
required
Response
Steering message promoted to a follow-up task
object
required
message
SteeringMessage
required
promotedTaskId
string