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

# List Workspaces

> Lists every workspace the authenticated account owns or is a member of.

Available to any logged-in account — you don't need `members:read` on any workspace to list the
ones you belong to. An API key needs the `workspaces:read` scope.

### Response

<ResponseField name="response" type="APIWorkspace[]">
  <Expandable title="Toggle object">
    <ResponseField name="id" type="string" />

    <ResponseField name="name" type="string" />

    <ResponseField name="description" type="string | null" />

    <ResponseField name="owner_id" type="string" />

    <ResponseField name="owner" type="object">`{ display_name }` of the owner.</ResponseField>

    <ResponseField name="members_count" type="number" />

    <ResponseField name="deleted_at" type="string | null" format="date-time">Soft-delete marker. Always `null` here — deleted workspaces don't list.</ResponseField>

    <ResponseField name="created_at" type="string" format="date-time" />

    <ResponseField name="updated_at" type="string" format="date-time" />
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "response": [
      {
        "id": "b7e2d1a4-...",
        "name": "Acme backend",
        "description": "Production apps and databases",
        "owner_id": "123456789012345678",
        "owner": { "display_name": "Alice" },
        "members_count": 4,
        "deleted_at": null,
        "created_at": "2026-09-01T12:00:00Z",
        "updated_at": "2026-09-01T12:00:00Z"
      }
    ]
  }
  ```
</ResponseExample>