staqlydocs
REST APIAPI referenceAuth

Agents seen talking to the workspace, most recently active first

Agents seen talking to the workspace, most recently active first

Every request sends Authorization: Bearer ...: the access token in local mode, an API key stk_... in cloud mode. Use Send to try it against your cloud instance with your API key.

GET
/v1/agents

Recorded automatically: MCP clients by their clientInfo (Claude Code, Codex, Cursor...), REST clients by their User-Agent (an SDK's appended user agent names the agent), per credential. Browsers are not agents. Needs admin: it names the API keys agents use. At most 200 agents are kept per workspace.

Authorization

headerAuthorizationBearer <token>

API key (stk_...), or in the Community Edition the access token (stk_local_...)

Response Body

OK

application/json
  1. response
data*array<>
curl -X GET 'https://staqly.example.com/v1/agents'
{  "data": [    {      "id": "string",      "kind": "mcp",      "name": "string",      "version": "string",      "principal_id": "string",      "principal_name": "string",      "first_seen_at": "2019-08-24T14:15:22Z",      "last_seen_at": "2019-08-24T14:15:22Z",      "requests": 0,      "posts_created": 0    }  ]}