Agents
The Agents operations of the Hub REST API (5 operations).
bearerAuthAuthorizationBearer <API key>Pod API key (Bearer) issued via /api/hub/setup/agent or pod admin tooling. Browser/web clients may use the X-Session-Token header instead. See GET /api/hub/auth/status to introspect the calling key.
workspaceId?stringparentUserId?stringFilter agents by agentMetadata.parentAgentId — used by orchestrators to discover their personalities.
Agent users
application/json- response
[index: integer]?curl -X GET 'https://pod.example.com/api/hub/agent-users'[ { "id": "string", "name": "string", "agentMetadata": { "property1": null, "property2": null }, "role": "string", "reach": "pod", "binding": { "toolId": "string", "provider": "string", "supports": { "push": true, "inputRequired": true, "cancel": true }, "error": { "code": "string", "message": "string" } }, "connections": [ { "keyId": "string", "instanceId": "string", "instanceLabel": "string", "displayName": "string", "createdAt": "string", "lastUsedAt": "string" } ], "property1": null, "property2": null }]bearerAuthAuthorizationBearer <API key>Pod API key (Bearer) issued via /api/hub/setup/agent or pod admin tooling. Browser/web clients may use the X-Session-Token header instead. See GET /api/hub/auth/status to introspect the calling key.
userId*stringAgent user ID (the personality).
workspaceId?stringWorkspace ID. If omitted, returns all configs for this userId across workspaces.
agentType?stringFree-form agent type slug. If set, narrows to a single row.
Array of agent_configs rows
application/json- response
[index: integer]?curl -X GET 'https://pod.example.com/api/hub/agent-configs?userId=string'[ { "id": "string", "userId": "string", "workspaceId": "string", "agentType": "string", "promptAppend": "string", "extraToolIds": [ "string" ], "disabledToolIds": [ "string" ], "maxStepsOverride": 0, "modelOverride": "string", "createdAt": "string", "updatedAt": "string", "property1": null, "property2": null }]bearerAuthAuthorizationBearer <API key>Pod API key (Bearer) issued via /api/hub/setup/agent or pod admin tooling. Browser/web clients may use the X-Session-Token header instead. See GET /api/hub/auth/status to introspect the calling key.
application/json- body
channelId*stringuserId*stringworkspaceId*stringsystemPromptOverride*stringskillId?stringentityId?stringEntity to inject as context for the AI response.
Trigger result (varies by skill/agent)
application/json- response
[key: string]?unknowncurl -X POST 'https://pod.example.com/api/hub/channels/trigger-ai' \ -H 'Content-Type: application/json' \ -d '{ "channelId": "string", "userId": "string", "workspaceId": "string", "systemPromptOverride": "string"}'{ "property1": null, "property2": null}bearerAuthAuthorizationBearer <API key>Pod API key (Bearer) issued via /api/hub/setup/agent or pod admin tooling. Browser/web clients may use the X-Session-Token header instead. See GET /api/hub/auth/status to introspect the calling key.
application/json- body
workspaceId?stringuuiddiscordChannelId*string1 <= lengthguildId?string1 <= length <= 64discordUserId*string1 <= lengthdiscordUsername*string1 <= lengthchannelKind?string"dm""guild"text?stringlength <= 50000""messageId*string1 <= lengthattachments?array<>items <= 4skillName?string1 <= length <= 200priority?string"interactive""background"Agent reply (may be partial with steps when timed out mid-stream)
application/json- response
reply*stringdeliverToExternalChannelId?stringsuppressReply?booleanneedsConnect?booleandiscordUserId?stringsteps?array<>partial?booleantimedOut?booleanerror?stringturnId?stringuuidcurl -X POST 'https://pod.example.com/api/hub/discord/agent-turn' \ -H 'Content-Type: application/json' \ -d '{ "discordChannelId": "string", "discordUserId": "string", "discordUsername": "string", "messageId": "string"}'{ "reply": "string", "deliverToExternalChannelId": "string", "suppressReply": true, "needsConnect": true, "discordUserId": "string", "steps": [ { "id": "string", "type": "string", "content": "string", "timestamp": "string", "toolName": "string", "toolInput": null, "toolOutput": null, "duration": 0, "error": "string", "title": "string", "description": "string", "status": "pending", "property1": null, "property2": null } ], "partial": true, "timedOut": true, "error": "string", "turnId": "7513f73d-27ec-455d-85b7-7bd021b4dccf"}bearerAuthAuthorizationBearer <API key>Pod API key (Bearer) issued via /api/hub/setup/agent or pod admin tooling. Browser/web clients may use the X-Session-Token header instead. See GET /api/hub/auth/status to introspect the calling key.
Success
curl -X POST 'https://pod.example.com/api/hub/agents/sync'