> ## Documentation Index
> Fetch the complete documentation index at: https://docs.userplane.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Current User

> Retrieve the authenticated user's profile and aggregate stats

Returns the profile and aggregate statistics for the user associated with the API key.

## Errors

This endpoint only returns [common authentication errors](/api/error-handling#authentication-errors).

## Related

<CardGroup cols={2}>
  <Card title="List Workspaces" icon="building" href="/api/workspaces/list-workspaces">
    Retrieve the workspaces you belong to
  </Card>

  <Card title="Authentication" icon="key" href="/api/authentication">
    API key authentication and scoping
  </Card>

  <Card title="Quickstart" icon="bolt" href="/api/quickstart">
    Make your first API call step by step
  </Card>

  <Card title="Error Handling" icon="triangle-exclamation" href="/api/error-handling">
    Handle authentication and authorization errors
  </Card>
</CardGroup>


## OpenAPI

````yaml GET /public/me
openapi: 3.1.1
info:
  title: Userplane Public API
  version: 1.0.0
  description: >-
    Programmatic access to Userplane workspaces, recordings, and links.
    Authenticate with a Bearer token using your API key (uspl_ prefix).
servers:
  - url: https://api.userplane.io/api/v1
    description: Production
security:
  - bearerAuth: []
paths:
  /public/me:
    get:
      tags:
        - Me
      summary: Get current user profile
      description: Retrieve the authenticated user's profile and aggregate stats
      operationId: me
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  data:
                    type: object
                    properties:
                      user:
                        type: object
                        properties:
                          id:
                            type: string
                          name:
                            type: string
                          email:
                            type: string
                          emailVerified:
                            type: boolean
                          image:
                            anyOf:
                              - type: string
                              - type: 'null'
                          createdAt: {}
                        required:
                          - id
                          - name
                          - email
                          - emailVerified
                          - image
                          - createdAt
                        additionalProperties: false
                      stats:
                        type: object
                        properties:
                          workspaces:
                            type: integer
                            minimum: 0
                            maximum: 9007199254740991
                          recordings:
                            type: integer
                            minimum: 0
                            maximum: 9007199254740991
                          links:
                            type: integer
                            minimum: 0
                            maximum: 9007199254740991
                        required:
                          - workspaces
                          - recordings
                          - links
                        additionalProperties: false
                    required:
                      - user
                      - stats
                    additionalProperties: false
                required:
                  - message
                  - data
                additionalProperties: false
        '400':
          description: '400'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: BAD_REQUEST
                      status:
                        const: 400
                      message:
                        type: string
                        default: >-
                          Invalid request parameters. Check the request body and
                          query parameters. See
                          https://docs.userplane.io/api/error-handling
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
        '401':
          description: '401'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: API_KEY_REQUIRED
                      status:
                        const: 401
                      message:
                        type: string
                        default: >-
                          API key is required. Include it as Authorization:
                          Bearer <your-api-key>. See
                          https://docs.userplane.io/api/authentication
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: API_KEY_INVALID
                      status:
                        const: 401
                      message:
                        type: string
                        default: >-
                          The provided API key is not valid. Verify the key and
                          try again. See
                          https://docs.userplane.io/api/authentication
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: API_KEY_EXPIRED
                      status:
                        const: 401
                      message:
                        type: string
                        default: >-
                          The API key has expired. Rotate or create a new key.
                          See https://docs.userplane.io/api/authentication
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
        '403':
          description: '403'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: API_KEY_DISABLED
                      status:
                        const: 403
                      message:
                        type: string
                        default: >-
                          The API key is disabled. Enable it or create a new
                          key. See https://docs.userplane.io/api/authentication
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: NOT_A_MEMBER
                      status:
                        const: 403
                      message:
                        type: string
                        default: >-
                          The API key owner is not a member of this workspace.
                          See https://docs.userplane.io/api/error-handling
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
        '404':
          description: '404'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: WORKSPACE_NOT_FOUND
                      status:
                        const: 404
                      message:
                        type: string
                        default: Workspace not found
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
        '410':
          description: '410'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: WORKSPACE_GONE
                      status:
                        const: 410
                      message:
                        type: string
                        default: Workspace has been deleted
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
        '429':
          description: '429'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: RATE_LIMITED
                      status:
                        const: 429
                      message:
                        type: string
                        default: >-
                          Rate limit exceeded. Wait and retry with exponential
                          backoff. See https://docs.userplane.io/api/rate-limits
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
        '503':
          description: '503'
          content:
            application/json:
              schema:
                oneOf:
                  - type: object
                    properties:
                      defined:
                        const: true
                      code:
                        const: SERVICE_UNAVAILABLE
                      status:
                        const: 503
                      message:
                        type: string
                        default: >-
                          API key verification service is temporarily
                          unavailable. Please try again later. See
                          https://docs.userplane.io/api/error-handling
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
                  - type: object
                    properties:
                      defined:
                        const: false
                      code:
                        type: string
                      status:
                        type: number
                      message:
                        type: string
                      data: {}
                    required:
                      - defined
                      - code
                      - status
                      - message
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key with uspl_ prefix. Create keys at
        dash.userplane.io/_/account?tab=developers

````