Workspace API - CollabOS Developers

Workspace API keys are scoped to exactly one CollabOS workspace.

Available reads

Workspace raffles
A single workspace raffle
Entries for a workspace raffle
Finalized winners for a workspace raffle
Developer-safe workspace projects

The current workspace API is read-only. It does not create, edit, publish, cancel, or finalize raffles.

Example: list workspace raffles

curl "https://api.collabos.app/api/v1/workspaces/WORKSPACE_ID/raffles?limit=20" \
  -H "Authorization: Bearer $COLLABOS_WORKSPACE_API_KEY"

Example: list workspace projects

curl "https://api.collabos.app/api/v1/workspaces/WORKSPACE_ID/projects?limit=50" \
  -H "Authorization: Bearer $COLLABOS_WORKSPACE_API_KEY"

Workspace isolation

Every workspace route contains a workspaceId, but the route value must match the workspace attached to the API key. A key for one workspace cannot read another workspace by changing the URL.

Project data

projects:read returns an explicit developer-safe project view. Internal contact management, staff assignment, notes, winner-sheet URLs, creator IDs, and follow-up fields are not included.

Managing workspace developer access

Workspace API keys and webhooks can be managed by active workspace owners and admins when the workspace has developer access through an eligible CollabOS workspace product.