Get Me

GET /auth/me

Role floor

Requires viewer or above. The floor is a minimum, not a grant: scope filtering still applies on top of it, and a resource in another tenant answers 404 rather than 403.

Responses

Status	Description	Body
200	Successful Response	PrincipalView

Only the success paths are declared

Any operation may also answer any status in the error catalogue, and every failure body is the platform envelope — including the 422 this document types as HTTPValidationError.

Example

curl -X GET https://your-deployment.example.com/auth/me \
  -H "Authorization: Bearer $COBRE_TOKEN"

Response — PrincipalView

Field	Type		Notes
principal_kind	user | service_key | system	required	—
principal_id	string (uuid) | null	optional	—
email	string | null	optional	—
full_name	string | null	optional	—
role	viewer | member | admin | owner | operator	required	—
scope	workspace | organization | platform	required	—
organization_id	string (uuid) | null	optional	—
workspace_id	string (uuid) | null	optional	—
acting_as_id	string (uuid) | null	optional	—
permissions	string[]	optional	—