KBAISE/ for lovable
Library
Docs

List workspaces

about 5 minBuildingchecked 2h agoOfficial page
The short version

This lets you get a list of all the workspaces you can access in Lovable. You'll see them ordered by when you joined them, with the oldest ones first.

Anyone who needs to see all their Lovable workspaces and their basic details.

Do this, in order

  1. 1

    Make sure your Lovable account has a 'Business' plan or higher.

    This feature is only available for Business plans and above.

  2. 2

    Create an API key with 'workspaces:read' permission.

    You need this specific permission to securely access your workspace information.

  3. 3

    Use the provided prompt to ask Lovable to list your workspaces.

    This will send a request to Lovable's system to retrieve the list of workspaces you can see.

Paste this into your project

Lovable, please list all the workspaces I have access to. Include their names and IDs. If there are many, please provide them in pages of up to 50 at a time, and tell me if there are more pages to retrieve.

Words decoded

Workspace
A workspace is like a dedicated area or folder in Lovable where you keep your projects and collaborate with your team.
API key
An API key is a secret code that acts like a password, allowing your tools or prompts to securely communicate with Lovable's systems.
Scope
Scope defines what an API key is allowed to do. For example, 'workspaces:read' means the key can only view workspace information, not change it.
Cursor pagination
This is a way to get a long list of items in smaller chunks. You get the first chunk, and if there are more, Lovable gives you a 'cursor' (a pointer) to ask for the next chunk.
Eventually consistent
This means that some information, like the number of projects in a workspace, might not update instantly after a change. It will catch up eventually, but there might be a small delay.

Where people get stuck

  • You won't be able to use this feature if your Lovable plan is lower than 'Business'.
  • If your API key doesn't have 'workspaces:read' permission, the request will fail.
  • If you use an API key that is tied to a specific workspace, you will only see that single workspace, not all of them.
  • The count of projects for a workspace might not be perfectly up-to-date immediately after you create or delete a project.

The short version, steps, decoder and prompt on this page are written automatically from Lovable's own documentation and can lag or misread it. The official page is always the authority.