---
title: "List the workspaces the caller can act in"
method: GET
path: "/workspaces"
tags: ["Account"]
---

# List the workspaces the caller can act in

`GET /workspaces`

## Request

- Base URL: `https://post.adaptlypost.com/post/api/v1`
- URL: `https://post.adaptlypost.com/post/api/v1/workspaces`
- Auth: HTTP bearer

An OAuth sign-in reaches every workspace its member belongs to, across organizations; an API key reaches only its own. Send a returned `id` in the `X-Workspace-Id` header to act in that workspace. `current` marks the workspace this call landed in. Open to every valid key, whatever its role, so an agent can find out what it may do before it tries.

## Headers

- `X-Workspace-Id` string

## Response `200`

The reachable workspaces

- WorkspaceList
  - `workspaces` Workspace[], required
    - `id` string, required: Send it in the `X-Workspace-Id` header
    - `name` string, required
    - `organization` object, required
      - `id` string, required
      - `name` string, required
    - `role` object, required
      - `key` string, required
      - `name` string, required
    - `permissions` string[], required
    - `isDefault` boolean, required
    - `current` boolean, required: True for the workspace this call landed in
    - `can` object, required
      - `draft` boolean, required
      - `schedule` boolean, required
      - `publish` boolean, required

## Other responses

- `401`: Invalid or missing API key
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api.md) · [All operations](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/adaptlypost/apis/adaptlypost-public-api/revisions/8390a5fa9a0d?raw)