---
title: "List workspaces"
method: GET
path: "/workspaces"
tags: ["Workspace"]
---

# List workspaces

`GET /workspaces`

## Request

- Base URL: `https://api.emailchaser.com/r`
- URL: `https://api.emailchaser.com/r/workspaces`
- Auth: HTTP bearer

Lists the workspaces owned by the API key's workspace owner: the main workspace and its sub-workspaces. isCurrent marks the workspace the calling key is bound to.

## Response `200`

Workspaces owned by the key's workspace owner

- ModelsListWorkspacesResponse
  - `total` integer
  - `workspaces` ModelsWorkspaceItem[]
    - `createdAt` string
    - `iconUrl` string: IconURL is where the workspace's icon image can be loaded from. Empty when the workspace has none. Icons are uploaded in the app.
    - `id` integer
    - `isCurrent` boolean: IsCurrent is true for the workspace the calling API key is bound to.
    - `name` string

## Other responses

- `401`: Unauthorized - invalid or missing API key
- `500`: Failed to list workspaces

---

[API](https://skmtc.dev/emailchaser/apis/emailchaser-api.md) · [All operations](https://skmtc.dev/emailchaser/apis/emailchaser-api/llms.txt) · [OpenAPI document](https://skmtc.dev/emailchaser/apis/emailchaser-api/revisions/8b114990abb7?raw)