GET /api/v1/api-keys

{
  "data": [
    {
      "id": "key_abc123",
      "name": "Production SDK",
      "prefix": "ai_1234",
      "scopes": ["evaluate", "read"],
      "last_used_at": "2026-03-23T12:00:00.000Z",
      "created_at": "2026-03-20T10:00:00.000Z",
      "expires_at": null
    }
  ]
}

POST /api/v1/api-keys

{
  "name": "Production SDK",
  "scopes": ["evaluate", "read"],
  "expires_at": "2027-03-23T00:00:00.000Z"
}

{
  "data": {
    "id": "key_abc123",
    "name": "Production SDK",
    "key": "ai_full_key_shown_only_once",
    "prefix": "ai_1234",
    "scopes": ["evaluate", "read"],
    "created_at": "2026-03-23T10:00:00.000Z"
  }
}

DELETE /api/v1/api-keys/:id

POST /api/v1/api-keys/:id/rotate

{
  "data": {
    "id": "key_abc123",
    "key": "ai_new_key_shown_only_once",
    "prefix": "ai_5678"
  }
}

curl -H "Authorization: Bearer ai_your_key_here" \
  https://api.sidclaw.com/api/v1/agents

import { AgentIdentityClient } from '@sidclaw/sdk';

const client = new AgentIdentityClient({
  apiKey: 'ai_your_key_here',
  agentId: 'ag_abc123',
});

from sidclaw import SidClaw

client = SidClaw(
    api_key="ai_your_key_here",
    agent_id="ag_abc123",
)