---
title: "Get current identity and permissions"
method: GET
path: "/v1/whoami"
tags: ["Who Am I"]
---

# Get current identity and permissions

`GET /v1/whoami`

## Request

- Base URL: `https://blobsrus.omniapp.co/api`
- URL: `https://blobsrus.omniapp.co/api/v1/whoami`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

Retrieve the authenticated caller's own identity, API key scope, organization role, and resolved per-model permissions. Useful for allowing a caller to determine if they can execute a specific action without attempting it. Pass `modelId` to scope `rolesByModel` to specific models.

This endpoint can be used by any user with a valid API key.

## Query parameters

- `modelId` string

## Response `200`

Caller's identity, key scope, org role, and per-model permissions

- object
  - `keyScope` 'user' | 'organization', required: Scope of the API key in use. - `user` - Personal Access Token. This is a user-scoped key (PAT/OAuth) that acts as a single user and cannot use SCIM, regardless of the user's organization role. - `organization` - Organization API key
  - `orgRole` 'MEMBER' | 'ORG_ADMIN', required: The caller's organization role.
  - `rolesByModel` object, required: Resolved role and effective permissions per model, keyed by model ID. Connection role resolves per shared model, so this is per-model rather than a single global role.
  - `rolesByModelTruncated` boolean: Present and `true` when `rolesByModel` was truncated because the caller can access more models than the unfiltered limit. Pass a `modelId` filter to retrieve specific models.
  - `user` WhoamiUser, required
    - `id` string, required: The caller's user ID
    - `membershipId` string, required: The caller's own membership ID within this organization. This is the ID accepted by the [Get model roles endpoint](/api/user-model-roles/retrieve-user-model-roles) and is distinct from the user ID.

## Other responses

- `401`: Authentication required
- `404`: One or more requested `modelId`s do not exist or are not accessible to the caller

## Changes

- **2026-11-03** `43290040f88f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/omni/apis/omni-api/changes/v1/whoami/get.md)

---

[API](https://skmtc.dev/omni/apis/omni-api.md) - [All operations](https://skmtc.dev/omni/apis/omni-api/llms.txt) - [OpenAPI document](https://skmtc.dev/omni/apis/omni-api/revisions/43290040f88f?raw)