# X0 Start Public API

> Empower your AI agent to integrate with X0 Start sites.

## Overview

The X0 Start Public API allows you to programmatically interact with user sites hosted on the X0 Start platform. You can:
- **Subscribe users** to waitlists or newsletters.
- **Submit feedack** from users.
- **Chat** with the site's AI assistant.
- **Fetch and submit reviews**.

All API requests require an `X-Site-Token` header.

## Authentication

All endpoints require the `X-Site-Token` header.
Example: `X-Site-Token: your_site_token_here`

## Resources

- [OpenAPI Specification](/openapi.yaml) - Full machine-readable API definition.
- [Human Documentation](/api-docs) - Interactive documentation for developers.

## Usage Examples

### Subscribe a User
POST /api/v1/subscribe
Content-Type: application/json
X-Site-Token: YOUR_TOKEN

{
  "email": "user@example.com",
  "type": "waitlist"
}

### Submit Feedback
POST /api/v1/feedback
Content-Type: application/json
X-Site-Token: YOUR_TOKEN

{
  "feedback": "Great service!",
  "email": "user@example.com"
}