---
title: "Get User"
method: GET
path: "/api/v1/user/"
tags: ["User"]
---

# Get User

`GET /api/v1/user/`

## Request

- Base URL: `http://localhost:3009`
- URL: `http://localhost:3009/api/v1/user/`
- Auth: HTTP bearer

Returns the authenticated caller's bootstrap payload: identity and org membership. Use List Workflows for accessible workflow metadata.

## Response `200`

Default Response

- object
  - `status` integer
  - `data` User: Caller bootstrap payload. Identity and org membership are always present. Use List Workflows for accessible workflow metadata.
    - `email` string, email, required: Caller's email address (Floqer username).
    - `first_name` unknown, required
    - `last_name` unknown, required
    - `role` 'admin' | 'member' | 'user', required: Organization role: `admin` (org lead), `member`, or `user` (sources, shortcut runs, connections only). A label only; gate on `scopes`, which is authoritative (an unrecognised stored role reads as `member` with no scopes). Renamed from `operator` in STAP-3793.
    - `scopes` string[], required: Effective permissions for this session: the key's scopes narrowed to what the caller's role allows. `["*"]` means everything. A call needing a scope not listed here is refused with `ROLE_FORBIDDEN`.
    - `org_id` string, required: UUID of the caller's organization.
    - `org_members` UserOrgMembers, required: Members of the caller's organization. Emails are Floqer usernames.
      - `count` integer, required: Number of members in the organization.
      - `emails` string[], required: Email address of each org member (Floqer username), sorted alphabetically.

## Other responses

- `401`: Unauthorized — missing or invalid API key
- `403`: Forbidden. `code` says which permission refused: ROLE_FORBIDDEN (your role), INSUFFICIENT_SCOPE (the API key's scopes), WORKFLOW_FORBIDDEN (no access to the workflow), KEY_WORKFLOW_FORBIDDEN (the API key's workflow restriction).
- `429`: Too Many Requests — rate limit exceeded. Check `Retry-After` header for seconds until the limit resets.

---

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