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

# Verify API key

> Validates the API key supplied in the `Authorization` header and returns the caller's identity. Use this as the first call in any CLI or integration to confirm the key is valid and retrieve the user it belongs to.


Call this endpoint after the user provides an API key to your CLI or tool to confirm it is valid
and to display who they are authenticated as.

<Note>Sensitive fields such as billing details, payment method, and social links are intentionally excluded from this response.</Note>


## OpenAPI

````yaml /openapi.yaml get /auth/verify
openapi: 3.1.0
info:
  title: Versuno Public API
  description: >
    The Versuno Public API lets you manage AI assets, projects, and version
    history programmatically.


    All endpoints except key management require a Bearer API key in the
    `Authorization` header.

    API keys are formatted as
    `uk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`.
  version: 1.0.0
  contact:
    email: support@versuno.ai
servers:
  - url: https://versuno.ai/api/public
    description: Production
  - url: http://localhost:3000/api/public
    description: Local development
security:
  - bearerAuth: []
tags:
  - name: Authentication
    description: Verify API key validity and retrieve the caller's identity.
  - name: Teams
    description: Teams the authenticated user owns or is an active member of.
  - name: Assets
    description: AI assets — prompts, personas, contexts, system prompts, and skills.
  - name: Asset Trash
    description: Single-asset soft-delete, restore, and permanent delete lifecycle.
  - name: Bulk Asset Trash
    description: Bulk trash operations across multiple assets at once.
  - name: Projects
    description: Project folders for organising assets and teams.
  - name: Project Trash
    description: Project trash lifecycle — trashing deletes the entire subtree.
  - name: Versioning
    description: Full-snapshot version history with non-destructive revert support.
  - name: Public Brains
    description: >-
      Graph-based knowledge structures composed of containers (folders/groups)
      and nodes (content items). Read the graph, or run semantic RAG queries
      against it.
  - name: Memory
    description: >-
      The universal agent-memory layer. Capture coding-agent memory, recall it
      semantically, and resolve contradictions. Capture-only, scoped to your API
      key's account.
  - name: Key Management
    description: >-
      Create, update, and delete API keys. These endpoints do not require a
      Bearer token.
paths:
  /auth/verify:
    get:
      tags:
        - Authentication
      summary: Verify API key
      description: >
        Validates the API key supplied in the `Authorization` header and returns
        the caller's identity. Use this as the first call in any CLI or
        integration to confirm the key is valid and retrieve the user it belongs
        to.
      operationId: verifyApiKey
      responses:
        '200':
          description: API key is valid. Returns the caller's identity.
          content:
            application/json:
              schema:
                type: object
                properties:
                  userId:
                    type: string
                    format: uuid
                    description: Unique identifier of the authenticated user.
                    example: b2c3d4e5-f6a7-8901-bcde-f12345678901
                  username:
                    type: string
                    description: The user's unique username.
                    example: kostek
                  fullName:
                    type: string
                    description: The user's display name.
                    example: Kostek Sytnyk
                  email:
                    type: string
                    format: email
                    description: The user's email address.
                    example: kostek@versuno.ai
              example:
                userId: b2c3d4e5-f6a7-8901-bcde-f12345678901
                username: kostek
                fullName: Kostek Sytnyk
                email: kostek@versuno.ai
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error401'
        '404':
          description: Profile not found for the authenticated user.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error404'
components:
  schemas:
    Error401:
      type: object
      properties:
        error:
          type: string
          example: Invalid API key
    Error404:
      type: object
      properties:
        error:
          type: string
          example: Not found
  securitySchemes:
    bearerAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Versuno API key. Must be prefixed with `Bearer`. Format: `Bearer
        uk_live_...`
      x-default: Bearer uk_live_your_api_key_here

````