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

# Get All User Workspaces

> Retrieves a list of all workspaces accessible to the current user.

Return every workspace the authenticated user or API key can access. Most single-workspace integrations do not need this endpoint, but it is useful for admin panels that let operators switch context.

## When to use

* Workspace switchers in internal tools.
* Account audits where one user belongs to multiple workspaces.
* Setup flows that need to confirm which workspace owns an API key.

## Integration notes

Use the selected workspace's own API key for production call, campaign, and analytics operations.


## OpenAPI

````yaml get /workspace/all
openapi: 3.0.0
info:
  title: Ringg AI API Documentation
  description: >-
    This is the documentation for the Ringg AI APIs. The Ringg AI API follows
    RESTful principles, making it intuitive and easy to integrate with your
    applications. All API requests should be made to the base URL. The API
    accepts and returns data in JSON format. Ensure your requests include the
    appropriate Content-Type header for POST and PATCH requests.
  version: 2.0.0
servers:
  - url: https://prod-api.ringg.ai/ca/api/v0
security: []
tags:
  - name: workspace
    description: Endpoints for managing your workspace.
  - name: agent
    description: Endpoints for managing assistants (agents).
  - name: calling
    description: Endpoints for making and managing calls.
  - name: campaign
    description: Endpoints for managing campaigns.
  - name: analytics
    description: Endpoints for accessing call analytics and performance metrics.
  - name: termination
    description: Endpoints for terminating active calls using different methods.
  - name: knowledgebase
    description: Endpoints for managing knowledge bases.
paths:
  /workspace/all:
    get:
      tags:
        - workspace
      summary: Get All User Workspaces
      description: Retrieves a list of all workspaces accessible to the current user.
      operationId: getAllUserWorkspaces
      parameters:
        - name: X-API-KEY
          in: header
          description: (Required) Your Ringg AI API key.
          required: true
          schema:
            type: string
            example: 7251cb4b-3373-43a4-844c-b27a1d45e0c9
      responses:
        '200':
          description: 'Successful Response: A list of user workspaces.'
          content:
            application/json:
              schema:
                type: object
                properties:
                  workspaces:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          example: d079bcb3-72a3-42dc-9586-edf0328e2973
                        name:
                          type: string
                          example: Siddharth @ DesiVocal's Workspace
                        created_at:
                          type: string
                          format: date-time
                          example: '2024-12-16T13:03:29.947147+00:00'
                        role:
                          type: string
                          example: owner
                        credits:
                          type: integer
                          example: 3025
                        locked_credits:
                          type: integer
                          example: 0
        '401':
          description: Unauthorized - Invalid or missing API key.
        '500':
          description: Internal Server Error - Something went wrong on our end.

````