> ## Documentation Index
> Fetch the complete documentation index at: https://docs.collabos.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Workspace API

> Read workspace-owned raffles, entries, winners, and project data.

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

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

## Example: list workspace projects

```bash theme={null}
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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.