list_workspaces

Returns the workspaces this API key has access to, with connected social platforms per workspace. Use when you get a workspace_required error to see available options, then retry with workspaceId set.

Parameters

This tool takes no parameters.

When to use

Enumerate the workspaces the caller can act on. Useful for:

• Agents that need to present a workspace picker to the user
• Disambiguating "post to our LinkedIn" when the tenant has multiple workspaces
• Validating that a workspace ID from an earlier session is still accessible

This tool is NOT workspace-scoped — it does not take a workspaceId. The answer depends on the caller's identity (API key, OAuth token, user session).

Example

Call with an empty body (or no body at all, depending on client):

{}

Response:

{
  "workspaces": [
    { "id": "wks_01H...", "name": "Main Brand", "role": "editor" },
    { "id": "wks_01H...", "name": "Consumer Products", "role": "admin" }
  ]
}

role reflects the caller's effective access level in that workspace.

Gotchas

• The list is resolved live on every call. It never caches — if a tenant admin just granted new access, the next call reflects it.
• API keys with scope: "single" or "selected" return only their pinned workspaces regardless of the owning agent's current grants. Keys with scope: "all" track the agent's grants dynamically.
• Soft-deleted workspaces do NOT appear. If a workspace the caller used yesterday is missing today, it was either deleted or the caller's access was revoked.
• Do not cache the result across sessions; always re-fetch at session start.