/
DE
desplega-ai
/
Agent Swarm API
Search skmtc…
⌘K
Changes
Docs
Sign in
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Updated on 2026-09-26
Details
Filter operations
Active Sessions
8
Agents
12
API Keys
8
ApprovalRequests
4
Assets
4
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
12
Webhooks
5
WorkflowEvents
2
Workflows
17
Tasks
Mark task as completed or failed (runner endpoint)
post
/api/tasks/{id}/finish
Path parameters
id
string
required
Request body
object
required
status
'completed'
|
'failed'
required
output
string
failureReason
string
force
boolean
Response
Task finished
Changes