---
title: "Retrieve the current operator identity"
method: GET
path: "/me"
tags: ["Operator"]
---

# Retrieve the current operator identity

`GET /me`

## Request

- Base URL: `https://api.cavuno.com/v1`
- URL: `https://api.cavuno.com/v1/me`
- Auth: HTTP bearer

Returns the Board bound to the credential, the actor type, the current live role and effective product permissions, and (for API keys and OAuth tokens) the credential scopes. Use this instead of global role or permission catalogs.

## Response `200`

Successful response.

- Operator
  - `object` 'operator', required: String representing the object's type. Objects of the same type share the same value.
  - `board` object, required: The Board the credential is bound to.
    - `id` string, required: Unique identifier for the Board (account).
    - `slug` string, required: URL slug of the Board.
    - `name` string, required: Display name of the Board.
  - `actor` object, required: The authenticated principal.
    - `type` 'api_key' | 'oauth_token' | 'user_session', required: How this request authenticated.
    - `role` string, nullable, required: Current live membership role. Always `null` for API keys (Board-owned service credentials). Null for OAuth/session only when no live membership remains.
    - `permissions` string[], required: Current effective product permissions. API keys use the key's explicit scopes plus the lower levels they include (`publish` includes `manage`, `manage` includes `read`); OAuth is the intersection of token scopes and the consenting member's live permissions; sessions use the member's live permissions.
    - `scopes` string[], nullable, required: Credential scopes for API keys and OAuth tokens. Always `null` for user sessions.

## Other responses

- `default`: An error. Every non-2xx response uses the same envelope; see the Errors section of the introduction.

## Changes

- **2026-10-19** `c34152c38176`: 1 info
  - added the optional property `error/upgrade` to the response with the `default` status

[Operation history](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/changes/me/get.md)

---

[API](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api.md) · [All operations](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cavuno/apis/cavuno-v1-rest-api/revisions/d5974dabff14?raw)