Agents · listAgents

List agents

GET /v1/agents

The workspace's agents, newest first, each with its active API keys (never their secrets) and how many asks and events it sent in the last 30 days.

Who may call it: humans: Deciders and up
Server: https://api.logu.dev

Parameters#

Name	In	Type	Required	Description
`Logu-Workspace`	header	`string`	optional	Humans only: the workspace to act in (default: your personal workspace). Agents always act in their API key's workspace. · e.g. `wsp_01K7D7Y8Z0B2D4F6H8K0M2P4R6`

Example#

curl -s "https://api.logu.dev/v1/agents" \
  -H "Authorization: Bearer $LOGU_SESSION_TOKEN"

Responses#

200

Agents.

{
  "agents": [
    {
      "id": "agt_01K7D8F2H4K6M8P0R2T4V6X8Z0",
      "name": "deploy-bot",
      "notificationLevel": "asks_and_events",
      "createdAt": "2026-10-01T09:00:00.000Z",
      "apiKeys": [
        {
          "id": "key_01K7DB1A3C5E7G9J1L3N5Q7S9U",
          "name": "Claude",
          "prefix": "lga_",
          "test": false,
          "createdAt": "2026-10-02T09:00:00.000Z",
          "lastUsedAt": "2026-10-12T14:03:11.000Z",
          "connector": {
            "clientId": "oac_01K7DB3C5E7G9J1L3N5Q7S9U1W",
            "name": "Claude"
          }
        },
        {
          "id": "key_01K7D8F2J5N7Q9S1U3W5Y7A9C1",
          "name": "deploy-bot",
          "prefix": "lg_8fK2xQp",
          "test": false,
          "createdAt": "2026-10-01T09:00:00.000Z",
          "lastUsedAt": "2026-10-12T14:03:11.000Z",
          "connector": null
        }
      ],
      "asks30d": 14,
      "events30d": 62
    }
  ]
}

Response fields

Field	Type	Required	Notes
`agents`	`Agent[]`	required
`agents[].id`	`string`	required
`agents[].name`	`string`	required
`agents[].notificationLevel`	`"asks_and_events" \| "asks_only" \| "silent"`	required
`agents[].createdAt`	`string`	required	date-time
`agents[].apiKeys`	`ApiKey[]`	required
`agents[].apiKeys[].id`	`string`	required
`agents[].apiKeys[].name`	`string`	required
`agents[].apiKeys[].prefix`	`string`	required
`agents[].apiKeys[].test`	`boolean`	required
`agents[].apiKeys[].createdAt`	`string`	required	date-time
`agents[].apiKeys[].lastUsedAt`	`string \| null`	required	date-time
`agents[].apiKeys[].connector`	`object \| null`	required
`agents[].asks30d`	`integer`	required
`agents[].events30d`	`integer`	required

Errors#

Every error is {"error":{"code","message","hint","docUrl","requestId"}}: branch on code. See Errors.

Status	Code	Meaning
401	`unauthorized`	No credentials, or the API key or session is invalid or revoked.
403	`forbidden`	The caller is authenticated but may not do this (wrong role, or an API key on a human-only endpoint).
404	`not_found`	No such route, or the resource doesn't exist in your workspace.
500	`internal_error`	Something went wrong on Logu's side.