List agents

Endpoint: GET /v1/agents
Authentication: Bearer JWT

Returns all agents in the caller's organization. API keys are never returned; only metadata.

Example request

curl

curl -s "https://api.1claw.xyz/v1/agents" \
  -H "Authorization: Bearer <token>"

TypeScript

const { data } = await client.agents.list();
for (const a of data.agents) {
  console.log(a.name, a.id, a.is_active);
}

Example response (200)

{
  "agents": [
    {
      "id": "ec7e0226-30f0-4dda-b169-f060a3502603",
      "name": "CI Agent",
      "description": "GitHub Actions deploy",
      "auth_method": "api_key",
      "scopes": ["vaults:read"],
      "is_active": true,
      "created_at": "2026-02-18T12:00:00Z",
      "expires_at": null,
      "last_active_at": "2026-02-18T14:00:00Z"
    }
  ]
}