---
title: "The authenticated principal"
method: GET
path: "/v1/me"
tags: ["Principal"]
---

# The authenticated principal

`GET /v1/me`

## Request

- Base URL: `https://api.shardflux.dev`
- URL: `https://api.shardflux.dev/v1/me`
- Auth: HTTP bearer

## Response `200`

Default Response

- object
  - `type` union, required
    - 'user'
    - 'api_key'
  - `user` object, nullable, required
    - `id` string, uuid, required: UUIDv7, lowercase canonical form.
    - `email` string, required
    - `email_verified` boolean, required
    - `display_name` string, nullable, required
    - `mfa_enabled` boolean, required
  - `memberships` object[], required
    - `organization_id` string, uuid, required: UUIDv7, lowercase canonical form.
    - `organization_name` string, required
    - `organization_slug` string, required
    - `role` 'owner' | 'admin' | 'member' | 'billing', required
  - `api_key` object, nullable, required
    - `id` string, uuid, required: UUIDv7, lowercase canonical form.
    - `key_id` string, required
    - `organization_id` string, uuid, required: UUIDv7, lowercase canonical form.
    - `project_id` string, uuid, required: UUIDv7, lowercase canonical form.
    - `tool_permissions` string[], required
    - `created_by_user_id` string, uuid, nullable: UUIDv7, lowercase canonical form.

## Other responses

- `4XX`: Default Response
- `5XX`: Default Response

---

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