---
title: "List the workspaces you belong to"
method: GET
path: "/workspaces"
tags: ["Accounts"]
---

# List the workspaces you belong to

`GET /workspaces`

## Request

- Base URL: `https://api.posteahora.com/functions/v1/api`
- URL: `https://api.posteahora.com/functions/v1/api/workspaces`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/posteahora/apis/posteahora-public-api/docs/workspaces/get.ts> (a function with typed inputs; its response is checked against the schema)

A key is bound to one workspace; active=true marks the one this key acts in.

## Response `200`

OK

- object
  - `workspaces` Workspace[]
    - `id` string, uuid
    - `name` string
    - `isPersonal` boolean
    - `role` 'owner' | 'admin' | 'manager' | 'member' | 'viewer'
    - `active` boolean

## Other responses

- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/posteahora/apis/posteahora-public-api.md) - [All operations](https://skmtc.dev/posteahora/apis/posteahora-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/posteahora/apis/posteahora-public-api/revisions/552a8eb6c30f?raw)