Workspaces
Endpoints
Every workspace and organization route at a glance.
All routes require the Authorization header — and only that. None of
them require X-Workspace-Id (these are the routes you call to get a
workspace ID), and verify-invitation needs no authentication at all.
Workspaces
| Method | Path | Purpose |
|---|---|---|
| GET | /v1/workspace | List workspaces & find your ID |
| GET | /v1/workspace/{workspace_id} | Get one workspace |
| POST | /v1/workspace | Create a workspace |
| PUT | /v1/workspace/{workspace_id} | Edit a workspace |
| DELETE | /v1/workspace/{workspace_id} | Delete a workspace |
| GET | /v1/workspace/available-regions | List available regions |
| GET | /v1/workspace/{workspace_id}/members | List workspace members |
| POST | /v1/workspace/{workspace_id}/members | Add a workspace member |
| DELETE | /v1/workspace/{workspace_id}/members/{user_id} | Remove a workspace member |
Organizations
| Method | Path | Purpose |
|---|---|---|
| GET | /v1/organization/mine | Your organizations |
| POST | /v1/organization | Create an organization |
| GET | /v1/organization/{organization_id} | Get an organization |
| PUT | /v1/organization/{organization_id} | Update an organization |
| GET | /v1/organization/{organization_id}/members | List members |
| PUT | /v1/organization/{organization_id}/members/{member_user_id}/role | Change a member's role |
| DELETE | /v1/organization/{organization_id}/members/{member_user_id} | Remove a member |
| POST | /v1/organization/{organization_id}/invite | Send an invitation |
| GET | /v1/organization/{organization_id}/invitations | List invitations |
| GET | /v1/organization/verify-invitation | Verify an invitation token (no auth) |
| POST | /v1/organization/invitations/{invitation_id}/accept | Accept an invitation |
| POST | /v1/organization/invitations/{invitation_id}/decline | Decline an invitation |