Agent SwarmAgent Swarm

Users

Manage the user registry — create users, link cross-platform identities, mint tokens, merge duplicates, and triage unmapped senders

GET
/api/users

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Query Parameters

recentEvents?|
Range0 <= value <= 50

Response Body

curl -X GET "http://localhost:3013/api/users"
Empty
Empty
POST
/api/users

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X POST "http://localhost:3013/api/users" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
Empty
Empty
Empty
GET
/api/users/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Query Parameters

recentEvents?|
Range0 <= value <= 200

Response Body

curl -X GET "http://localhost:3013/api/users/string"
Empty
Empty
Empty
PATCH
/api/users/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X PATCH "http://localhost:3013/api/users/string" \  -H "Content-Type: application/json" \  -d '{}'
Empty
Empty
Empty
Empty
GET
/api/users/{id}/events

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Query Parameters

limit?integer
Range1 <= value <= 200
before?string

Response Body

curl -X GET "http://localhost:3013/api/users/string/events"
Empty
Empty
Empty
POST
/api/users/{id}/identities

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X POST "http://localhost:3013/api/users/string/identities" \  -H "Content-Type: application/json" \  -d '{    "kind": "string",    "externalId": "string"  }'
Empty
Empty
Empty
Empty
DELETE
/api/users/{id}/identities/{kind}/{externalId}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string
kind*string
externalId*string

Response Body

curl -X DELETE "http://localhost:3013/api/users/string/identities/string/string"
Empty
Empty
Empty
POST
/api/users/{id}/mcp-tokens

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X POST "http://localhost:3013/api/users/string/mcp-tokens" \  -H "Content-Type: application/json" \  -d '{}'
Empty
Empty
Empty
DELETE
/api/users/{id}/mcp-tokens/{tokenId}

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string
tokenId*string

Response Body

curl -X DELETE "http://localhost:3013/api/users/string/mcp-tokens/string"
Empty
Empty
Empty
POST
/api/users/{id}/merge

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X POST "http://localhost:3013/api/users/string/merge" \  -H "Content-Type: application/json" \  -d '{    "sourceUserId": "string"  }'
Empty
Empty
Empty
Empty
GET
/api/users/unmapped

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Query Parameters

kind?string
limit?integer
Range1 <= value <= 1000

Response Body

curl -X GET "http://localhost:3013/api/users/unmapped"
Empty
Empty
POST
/api/users/unmapped/{kind}/{externalId}/resolve

Authorization

bearerAuth
AuthorizationBearer <token>

API key via Authorization: Bearer <API_KEY>

In: header

Path Parameters

kind*string
externalId*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

curl -X POST "http://localhost:3013/api/users/unmapped/string/string/resolve" \  -H "Content-Type: application/json" \  -d '{    "userId": "string"  }'
Empty
Empty
Empty
Empty