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

# Waitlist

> Public waitlist signup endpoint for collecting interest before open-source launch.

## POST /api/v1/waitlist

Add an email address to the KaireonAI waitlist. Public endpoint (no authentication required). Rate limited to 20 requests per 60 seconds per IP.

### Request Body

| Field    | Type   | Required | Description                                     |
| -------- | ------ | -------- | ----------------------------------------------- |
| `email`  | string | Yes      | Valid email address                             |
| `source` | string | No       | Signup source identifier (default: `"website"`) |

### Example

```bash theme={null}
curl -X POST https://playground.kaireonai.com/api/v1/waitlist \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com",
    "source": "landing-page"
  }'
```

### Response (200)

```json theme={null}
{
  "message": "You're on the list! We'll notify you when we go open-source."
}
```

### Error Codes

| Code  | Reason                |
| ----- | --------------------- |
| `400` | Invalid email address |
| `429` | Rate limit exceeded   |
| `500` | Server error          |

<Note>
  Duplicate emails are handled gracefully -- if the email already exists, the request succeeds silently without creating a duplicate entry.
</Note>

### Authentication

None required. This is a public endpoint.