---
title: "List your workspaces"
description: "Find the workspace ID to use for API key management."
api: GET https://api.nuxie.ai/v1/workspaces
authMethod: bearer
playground: simple
search:
  tags: ["api", "workspace", "reference"]
  keywords: ["workspace ID", "memberships", "user session token"]
---

List the workspaces your Nuxie account belongs to. Choose a workspace's `id` when [creating an API key](/docs/api-reference/workspace/create-api-key).

## Authentication

Authenticate with the **user session bearer token** returned by [Create a user session](/docs/api-reference/workspace/create-session). A workspace `sk_` key cannot authenticate this operation.

## Response

- **`object`** · `string` · required

  `list`.

- **`data`** · `object[]` · required

  Workspaces where the signed-in user is a member.

  **Workspace fields**

  - **`object`** · `string` · required

    `workspace`.

  - **`id`** · `string` · required

    Workspace ID.

  - **`name`** · `string` · required

    Workspace name.

  - **`slug`** · `string` · required

    Workspace slug.

  - **`logo`** · `string` · required

    Workspace logo URL, or `null`.

  - **`created_at`** · `string` · required

    ISO 8601 creation time.

- **`has_more`** · `boolean` · required

  `false`; the response includes all memberships.

```sh title="cURL"
curl https://api.nuxie.ai/v1/workspaces \
  --header "Authorization: Bearer $NUXIE_USER_TOKEN"
```

```json title="200"
{
  "object": "list",
  "data": [
    {
      "object": "workspace",
      "id": "workspace-id",
      "name": "My workspace",
      "slug": "my-workspace",
      "logo": null,
      "created_at": "2026-08-21T12:00:00.000Z"
    }
  ],
  "has_more": false
}
```