/
DE
desplega-ai
/
Agent Swarm API
Search skmtc…
⌘K
Docs
Sign in
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Sources
Checked 1h ago · Updated 19h ago
View markdown
desplega-ai
Agent Swarm API
get
Get a single config entry by ID
v68
OpenAPI 3.1.0
raw.githubusercontent.com
2026-08-07
344
69
1.3 MB
Active Sessions
8
Agents
12
API Keys
8
ApprovalRequests
4
Apps
20
Assets
4
Budgets
5
Config
7
get
Get resolved config (merged global + agent + repo scopes)
get
Check which of the given env var keys are currently set in process.env (presence only, no values)
post
Reload global swarm_config into process.env (override=true) and re-init integrations (Slack, GitHub, Linear, AgentMail)
get
Get a single config entry by ID
delete
Delete a config entry by ID (including legacy reserved rows for cleanup). Global-scope deletes auto-trigger an integrations reload.
get
List config entries with optional filters
put
Create or update a config entry (reserved env-only keys are rejected). Global-scope writes auto-trigger an integrations reload (debounced ~250ms) so Slack/GitHub/Linear/Jira/AgentMail pick up new credentials without an explicit /api/config/reload call.
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
12
Webhooks
5
WorkflowEvents
2
Workflows
17
Config
Get a single config entry by ID
get
/api/config/{id}
Path parameters
id
string
required
Query parameters
includeSecrets
'true'
|
'false'
Response
Config entry
object
required
id
string
uuid
required
scope
'global'
|
'agent'
|
'repo'
required
scopeId
string
nullable
required
key
string
required
value
string
required
isSecret
boolean
required
envPath
string
nullable
required
description
string
nullable
required
createdAt
string
required
lastUpdatedAt
string
required
encrypted
boolean
required
message
string