> ## 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 my teams

> Returns all teams the authenticated user owns or is an active member of, ordered by ownership then join date.

Returns active teams first (owned teams at the top), followed by any archived teams where the user is the owner.

<Note>Stripe billing fields are intentionally excluded from this response.</Note>


## OpenAPI

````yaml /openapi.yaml get /teams
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:
  /teams:
    get:
      tags:
        - Teams
      summary: List my teams
      description: >-
        Returns all teams the authenticated user owns or is an active member of,
        ordered by ownership then join date.
      operationId: listTeams
      responses:
        '200':
          description: Array of team objects with the caller's role and member count.
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    id:
                      type: string
                      format: uuid
                      description: Unique identifier of the team.
                      example: c3d4e5f6-a7b8-9012-cdef-123456789012
                    name:
                      type: string
                      description: Display name of the team.
                      example: Acme Corp
                    slug:
                      type: string
                      description: URL-safe identifier for the team.
                      example: acme-corp
                    status:
                      type: string
                      enum:
                        - active
                        - archived
                      description: Whether the team is active or archived.
                      example: active
                    myRole:
                      type: string
                      enum:
                        - owner
                        - admin
                        - member
                      description: The authenticated user's role in this team.
                      example: owner
                    memberCount:
                      type: integer
                      description: Number of active members in the team.
                      example: 4
                    createdAt:
                      type: string
                      format: date-time
                      description: When the team was created.
                      example: '2026-01-10T09:00:00.000Z'
              example:
                - id: c3d4e5f6-a7b8-9012-cdef-123456789012
                  name: Acme Corp
                  slug: acme-corp
                  status: active
                  myRole: owner
                  memberCount: 4
                  createdAt: '2026-01-10T09:00:00.000Z'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error401'
components:
  schemas:
    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

````