> ## 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.

# List public brains

> Returns all brains marked as public. Anyone with a valid API key can read these.



## OpenAPI

````yaml /openapi.yaml get /brains/public
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:
  /brains/public:
    get:
      tags:
        - Public Brains
      summary: List public brains
      description: >-
        Returns all brains marked as public. Anyone with a valid API key can
        read these.
      operationId: listPublicBrains
      responses:
        '200':
          description: Array of public brain objects.
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/Brain'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error401'
components:
  schemas:
    Brain:
      type: object
      description: >-
        A brain — a graph-based knowledge structure composed of containers and
        nodes.
      properties:
        id:
          type: string
          format: uuid
          description: Unique identifier for the brain.
          example: d4e5f6a7-b8c9-0123-def0-456789012345
        name:
          type: string
          description: Display name of the brain.
          example: Next.js Documentation
        slug:
          anyOf:
            - type: string
            - type: 'null'
          description: URL-safe identifier for the brain, or null.
          example: nextjs-docs
        description:
          anyOf:
            - type: string
            - type: 'null'
          description: Short summary of the brain.
          example: Indexed knowledge of the Next.js framework.
        overview:
          anyOf:
            - type: string
            - type: 'null'
          description: >-
            AI-generated long-form overview of the brain's contents, or null
            until generated.
          example: This brain covers routing, data fetching, rendering...
        isPublic:
          type: boolean
          description: Whether the brain is publicly readable.
          example: true
        sourceUrl:
          anyOf:
            - type: string
            - type: 'null'
          description: Origin URL the brain was indexed from, if any.
          example: https://nextjs.org/docs
        totalTokens:
          anyOf:
            - type: integer
            - type: 'null'
          description: Total token count across all indexed content, or null.
          example: 482000
        nodeCount:
          anyOf:
            - type: integer
            - type: 'null'
          description: Total number of nodes in the brain, or null.
          example: 1240
        pageCount:
          anyOf:
            - type: integer
            - type: 'null'
          description: Number of page-type nodes in the brain, or null.
          example: 312
        exampleQueries:
          anyOf:
            - type: array
              items:
                type: string
            - type: 'null'
          description: >-
            AI-generated example queries to seed callers, or null until
            populated.
          example:
            - How do I set up dynamic routes?
            - What is the difference between server and client components?
        lastIndexed:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          description: When the brain was last (re)indexed, or null.
          example: '2026-06-10T08:00:00.000Z'
        createdAt:
          type: string
          format: date-time
          description: When the brain was created.
          example: '2026-06-01T08:00:00.000Z'
    Error401:
      type: object
      properties:
        error:
          type: string
          example: Invalid API key
  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

````