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

# List workspaces

`GET /workspaces`

## Request

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

Returns all workspaces you have access to, along with their connected social accounts. Use this to get a `workspaceId` for other endpoints.

## Response `200`

List of workspaces

- object
  - `ok` boolean
  - `data` Workspace[]
    - `id` string, uuid
    - `name` string
    - `websiteUrl` string, nullable
    - `logoUrl` string, nullable
    - `domain` string, nullable
    - `socialAccounts` SocialAccountSummary[]
      - `id` string, uuid
      - `platform` 'FACEBOOK' | 'INSTAGRAM' | 'X' | 'LINKEDIN' | 'TIKTOK' | 'YOUTUBE' | 'THREADS' | 'BLUESKY' | 'PINTEREST' | 'GOOGLE_BUSINESS'
      - `accountName` string
      - `accountUrl` string, nullable
      - `profilePictureUrl` string, nullable
      - `customLabel` string, nullable: User-set label to distinguish accounts (e.g. "Downtown")

---

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