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

# List workspaces

> List the workspaces your API key can act on.

A partner workspace's key lists the partner's own workspace and the workspaces
it manages. Any other key lists its own workspace.

### Parameters

Supports [cursor pagination](/reference/pagination) with `limit`, `cursor`,
`starting_after`, and `ending_before`.

### Returns

Returns a list of [Workspace objects](/reference/workspaces/object).

<ResponseExample>
  ```json Response theme={null}
  {
    "workspaces": [
      {
        "id": "wsp_8rT2mVq5xNp3Kd",
        "name": "Acme Inc",
        "status": "active",
        "customer": "cus_6wJm3RkQp9xT2v",
        "created": "2026-08-04T16:20:00Z",
        "updated": "2026-08-04T16:20:00Z"
      }
    ]
  }
  ```
</ResponseExample>