Skip to main content
GET
/
workspace
/
all
Get All User Workspaces
curl --request GET \
  --url https://prod-api.ringg.ai/ca/api/v0/workspace/all \
  --header 'X-API-KEY: <x-api-key>'
{
  "workspaces": [
    {
      "id": "d079bcb3-72a3-42dc-9586-edf0328e2973",
      "name": "Siddharth @ DesiVocal's Workspace",
      "created_at": "2024-12-16T13:03:29.947147+00:00",
      "role": "owner",
      "credits": 3025,
      "locked_credits": 0
    }
  ]
}
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.

Headers

​
X-API-KEY
string
required

(Required) Your Ringg AI API key.

Example:

"7251cb4b-3373-43a4-844c-b27a1d45e0c9"

Response

Successful Response: A list of user workspaces.

​
workspaces
object[]