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

# API reference

> Current Contact Button API endpoints.

## Authentication

| Method | Path                               | Access                               |
| ------ | ---------------------------------- | ------------------------------------ |
| `POST` | `/auth/register`                   | Public, when registration is enabled |
| `POST` | `/auth/login`                      | Public                               |
| `POST` | `/auth/password/email`             | Public                               |
| `GET`  | `/auth/social/{provider}/callback` | Browser callback                     |

## Projects

All project-management endpoints require a bearer token and are scoped by the authenticated account.

| Method   | Path                                     | Purpose                          |
| -------- | ---------------------------------------- | -------------------------------- |
| `GET`    | `/projects`                              | List accessible projects         |
| `POST`   | `/projects`                              | Create a project                 |
| `GET`    | `/projects/{id}`                         | Retrieve a project               |
| `PUT`    | `/projects/{id}`                         | Update a project                 |
| `PUT`    | `/projects/{project}/toggle-state`       | Change project publication state |
| `DELETE` | `/projects`                              | Delete projects                  |
| `POST`   | `/projects/{project}/export/ftp`         | Export a project to FTP          |
| `POST`   | `/projects/{project}/generate-thumbnail` | Generate a project thumbnail     |
| `GET`    | `/projects/{project}/download`           | Download a project               |

Request and response schemas are being documented alongside the API contract. Until those schemas are published, treat the route definitions and server validation as authoritative.