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

# Get current user

> Return the profile of the currently authenticated user. Supports ``?embed=organizations,memberships,pending_invitations`` to include the user's orgs, role/scopes, and pending invitations addressed to their email.



## OpenAPI

````yaml /api/openapi.public.json get /v1/auth/me
openapi: 3.1.0
info:
  title: Runflow API
  version: 0.1.0
  description: >-
    Public Runflow API. Run AI image and video models, manage media, inspect run
    history, and configure webhooks. Auth: HTTP Bearer.


    This document is the customer integration surface only. Admin and internal
    operations plus generic system reference-data tables are intentionally
    omitted.
servers:
  - url: https://api.runflow.io
    description: Production
security:
  - HTTPBearer: []
tags:
  - name: Models
    description: >-
      Browse the model catalog and dispatch model runs. The primary surface for
      running AI image and video generation.
  - name: Runs
    description: >-
      Inspect, cancel, and re-run model executions. Fetch logs, node-runs, and
      callback delivery history.
  - name: Media
    description: >-
      Upload images and videos as inputs. Organize assets into folders.
      Three-step presigned upload flow for large files.
  - name: Batches
    description: >-
      Run a model on multiple inputs in one request. Includes per-item status
      and a single callback when the batch completes.
  - name: Evaluations
    description: >-
      Submit an image generated anywhere for automated quality evaluation, then
      read a pass verdict, a 0-1 score, and structured issues. No Runflow run
      required.
  - name: Webhooks
    description: >-
      Subscribe to platform events. Inspect delivery history, redeliver failed
      callbacks, manage signing secrets.
  - name: Account
    description: Read your account identity and credit balance.
  - name: Status
    description: Health and readiness probes for the API.
paths:
  /v1/auth/me:
    get:
      tags:
        - Account
      summary: Get current user
      description: >-
        Return the profile of the currently authenticated user. Supports
        ``?embed=organizations,memberships,pending_invitations`` to include the
        user's orgs, role/scopes, and pending invitations addressed to their
        email.
      operationId: getAuthMe
      parameters:
        - name: embed
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: >-
              Relation embedding. Available values: memberships, organizations,
              pending_invitations. Use a comma-separated list to request
              multiple embeds.
            title: Embed
          description: >-
            Relation embedding. Available values: memberships, organizations,
            pending_invitations. Use a comma-separated list to request multiple
            embeds.
          examples:
            single:
              summary: Single embed
              value: memberships
            multiple:
              summary: Multiple embeds
              value: memberships,organizations
      responses:
        '200':
          description: The authenticated user's profile.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/UserResponse'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - HTTPBearer: []
components:
  schemas:
    UserResponse:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        email:
          type: string
          title: Email
        first_name:
          anyOf:
            - type: string
            - type: 'null'
          title: First Name
        last_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Last Name
        avatar_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Avatar Url
        timezone:
          anyOf:
            - type: string
            - type: 'null'
          title: Timezone
        locale_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Locale Code
        email_verified_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Email Verified At
        memberships:
          anyOf:
            - items:
                $ref: '#/components/schemas/MembershipContext'
              type: array
            - type: 'null'
          title: Memberships
      type: object
      required:
        - id
        - email
        - first_name
        - last_name
        - avatar_url
        - timezone
        - locale_code
        - email_verified_at
      title: UserResponse
      description: Public user profile response.
    ErrorResponse:
      properties:
        code:
          type: string
          title: Code
        message:
          type: string
          title: Message
        errors:
          anyOf:
            - items:
                additionalProperties: true
                type: object
              type: array
            - type: 'null'
          title: Errors
      type: object
      required:
        - code
        - message
      title: ErrorResponse
      description: Standard error envelope — matches exception handler output.
    MembershipContext:
      properties:
        org:
          $ref: '#/components/schemas/OrgSummary'
        role_code:
          type: string
          title: Role Code
        scopes:
          items:
            type: string
          type: array
          title: Scopes
      type: object
      required:
        - org
        - role_code
        - scopes
      title: MembershipContext
      description: User's membership in one org — role + resolved permission scopes.
    OrgSummary:
      properties:
        id:
          type: string
          format: uuid
          title: Id
        name:
          type: string
          title: Name
        slug:
          type: string
          title: Slug
        plan_code:
          type: string
          title: Plan Code
      type: object
      required:
        - id
        - name
        - slug
        - plan_code
      title: OrgSummary
      description: Lightweight organization summary for membership context.
  securitySchemes:
    HTTPBearer:
      type: http
      scheme: bearer

````