Get Organization Workspaces

Developing

Develop Env

http://localhost:3000/api

GET

/orgs/{org_id}/workspaces

Maintainer:Suhaib Ghattass

Purpose
List all workspaces in an organization (paginated). Used in org dashboard or workspace switcher.

Auth / Scope
User must be a member of the org (org_members).

Headers
Authorization: Bearer <USER_JWT>
X-Page-Token: (for pagination)
Query Parameters
visibility=org (filter)
limit=20 (default: 20, max: 100)

Request

Path Params

Body Params application/jsonRequired

Examples

Responses

🟢200Success

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'http://localhost:3000/api/orgs//workspaces' \
--header 'Content-Type: application/json' \
--data-raw '{}'

Response Example

{
    "message": "Workspaces retrieved",
    "data": {
        "workspaces": [
            {
                "workspaceId": "w-abc",
                "name": "Marketing Team",
                "visibility": "org",
                "memberCount": 15,
                "createdAt": "2025-09-01T10:00:00Z"
            }
        ],
        "nextPageToken": "eyJsYXN0X2lkIjoidy16eXoifQ=="
    }
}

Modified at 2025-10-22 21:42:08

Domain verfying

Create Workspace