---
title: "List your workspaces (v2)"
method: GET
path: "/v2/workspaces/"
tags: ["workspaces"]
---

# List your workspaces (v2)

`GET /v2/workspaces/`

## Request

- Base URL: `https://api.prod.getdex.com`
- URL: `https://api.prod.getdex.com/v2/workspaces/`
- Auth: HTTP bearer

List the Dex for Teams workspaces you are an active member of, with your `role` in each and `api_access_enabled`, whether its owners and admins have opened it to members' API keys and MCP connections. Send a workspace `id` as the `X-Dex-Workspace` header to read and write that workspace with your key. Returns `{ data: { workspaces: [...] } }`; workspace content is never included.

## Response `200`

Successful response

- object
  - `data` object, required
    - `workspaces` object[], required
      - `id` string, uuid, required
      - `name` string, required
      - `slug` string, required
      - `image_url` string, nullable, required
      - `creator_user_id` string, required
      - `state` 'active' | 'pending_deletion', required
      - `deletion_scheduled_at` union, required
        - string, date-time
        - unknown
      - `deletion_due_at` union, required
        - string, date-time
        - unknown
      - `deletion_scheduled_by` string, nullable, required
      - `lifecycle_revision` integer, required
      - `share_emails` boolean, required
      - `share_social_profiles` boolean, required
      - `share_phone_numbers` boolean, required
      - `share_addresses` boolean, required
      - `share_notes` boolean, required
      - `api_access_enabled` boolean, required
      - `auto_add_contacts` boolean, required
      - `visible_social_networks` string[], required
      - `created_at` union, required
        - string, date-time
        - unknown
      - `updated_at` union, required
        - string, date-time
        - unknown
      - `role` 'owner' | 'admin' | 'standard' | 'viewer', required
    - `pagination` object
      - `nextCursor` string, nullable
      - `count` integer

## Other responses

- `400`: Request body failed validation.
- `401`: Missing or invalid API key.
- `403`: Valid key, insufficient permission.
- `404`: Resource does not exist.
- `409`: Request conflicts with the current state of the resource.
- `429`: Rate limit exceeded.
- `500`: Unexpected server error.

## Changes

- **2026-10-21** `6aeeebb0e493`: 2 info
  - added the required property `data/workspaces/items/share_notes` to the response with the `200` status
  - added the required property `data/workspaces/items/visible_social_networks` to the response with the `200` status
- **2026-10-20** `ea4a4df0f33e`: 1 info
  - added the required property `data/workspaces/items/auto_add_contacts` to the response with the `200` status
- **2026-10-08** `c2e4248f99b2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/getdex/apis/dex-public-api/changes/v2/workspaces/get.md)

---

[API](https://skmtc.dev/getdex/apis/dex-public-api.md) · [All operations](https://skmtc.dev/getdex/apis/dex-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getdex/apis/dex-public-api/revisions/657247ddcf7c?raw)