Agent and policy

Get the agent

Resolve the agent behind the session token.

GET/v1/agent-api/me

Responses

200

Agent identity

Response fields

agentobjectRequired

agent.idstringRequired

agent.namestringRequired

agent.status"pending_claim" | "active" | "suspended" | "pending_policy" | "revoked"Required

agent.organizationIdstringRequired

Updated October 29, 2026 Generated from the agent API's published OpenAPI document View as Markdown

import { createCatenaClient } from "@catena/sdk"

// Reads CATENA_SECRET_KEY
const client = createCatenaClient()

const agent = await client.whoami()

catena whoami

Response 200

{
  "agent": {
    "id": "agent_01JC2Y4H8M3T9V6Q2X7R5N1KPB",
    "name": "Invoice agent",
    "status": "active",
    "organizationId": "org_01JC2X9V7T5R3P1N8L6J4G2E0C"
  }
}