identity
- Category: sessions
- Access: read
- Audience: ordinary (an ordinary user normally calls this directly)
Purpose
Caller identity: own scopes, projects, server (read-only).
Arguments
Takes no arguments.
Result
JSON object with client_id, user, role, projects and server name/version.
Boundaries
Project-scoped reads; foreign projects read empty. Caller-owned rows only where applicable.
Lifecycle / side effects
Read-only; no rows written.
Errors
Bad types are rejected (strict validator). Failures move nothing (atomic).
Example
{}
Result shape:
{
"client_id": "<uuid>",
"role": "agent"
}