> ## 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.

# Personal API

> Use a personal API key to read public raffle data and the key owner's own activity.

Personal API keys are designed for integrations acting on behalf of one CollabOS user.

## What you can do

* Read the API-key owner's profile.
* List and read published public raffles.
* List the owner's entries and wins.
* Create or update a native raffle entry.
* Read the owner's entry for a raffle.
* Withdraw the owner's entry.

## Example: list public raffles

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

## Example: read your entries

```bash theme={null}
curl "https://api.collabos.app/api/v1/entries?limit=50" \
  -H "Authorization: Bearer $COLLABOS_API_KEY"
```

## Discovery boundary

The personal raffle API only returns raffles that are **public and published**. Private or community-only raffles are not exposed through the personal developer read API.

## Entry actions

Creating or updating an entry still follows CollabOS raffle rules. The API does not bypass requirements, eligibility checks, wallet or identity rules, or raffle lifecycle state.

Developer entry responses are sanitized. Internal requirement configuration and secrets are not returned.

## Availability

Personal API keys and personal webhooks require an active CollabOS Premium entitlement.

<Note>
  A personal key acts only as its owner. Cursors and request parameters cannot be used to switch to another user.
</Note>


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