/
DE
desplega-ai
/
Agent Swarm API
Search skmtc…
⌘K
Docs
Sign in
Sign in
APIs
Generators
Stacks
Projects
Docs
History
Schema
Sources
Checked 55m ago · Updated 5h ago
View markdown
desplega-ai
Agent Swarm API
post
Create a new user (optionally with initial identity links)
OpenAPI 3.1.0
raw.githubusercontent.com
2026-08-19
347
69
1.3 MB
9ab670324e5f
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
Create a new user (optionally with initial identity links)
post
/api/users
Request body
object
required
name
string
required
email
string
role
string
notes
string
emailAliases
string[]
preferredChannel
string
timezone
string
metadata
object
dailyBudgetUsd
number
nullable
status
'invited'
|
'active'
|
'suspended'
identities
object[]
Response
User created
object
required
user
object
nullable
required