identities

List agent identities with optional status/role filters.

status is validated against the :class:AgentIdentityStatus enum by FastAPI, so an unknown value yields a 422 rather than reaching the handler and raising an unhandled ValueError.

get/api/v1/identities

Request

  • The document declares no server URL.
  • Auth
    none declared

Query parameters

status'active' | 'suspended' | 'revoked'

Lifecycle status of an agent identity.

rolestring nullable

Response

Successful Response

unknown required

Changes