/
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 4h ago
View markdown
desplega-ai
Agent Swarm API
post
Link a new (kind, externalId) identity to this user
OpenAPI 3.1.0
raw.githubusercontent.com
2026-08-18
347
69
1.3 MB
031d17a13836
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
get
Resolve the authenticated principal behind the presented bearer
get
List all users with identities, token summaries and recent events
post
Create a new user (optionally with initial identity links)
get
List unmapped external identities (kv-backed triage queue)
post
Resolve an unmapped identity — link to an existing user or create a new one
get
Get a user by ID with identities, token summaries and recent events
patch
Update an existing user (profile / budget / status / email-aliases / identities)
post
Mint a one-time plaintext MCP token for a user
delete
Revoke a user's MCP token
post
Merge another user into this one — moves identities + email aliases, deletes source
get
Paginated identity-event timeline for a user (DESC by createdAt)
post
Link a new (kind, externalId) identity to this user
delete
Remove a (kind, externalId) identity link from this user
Webhooks
5
WorkflowEvents
2
Workflows
17
Users
Link a new (kind, externalId) identity to this user
post
/api/users/{id}/identities
Path parameters
id
string
required
Request body
object
required
kind
string
required
externalId
string
required
Response
Updated identity list
object
required
identities
object[]
required