Base path
https://platform.watermelonn.app/api/v1/admin
Auth and onboarding
| Method | Endpoint | Description |
|---|---|---|
| GET | /auth/me | Returns linked tenant and role for current user. |
| POST | /auth/onboard | Creates tenant and links current user as owner. |
Dashboard and operations
| Method | Endpoint | Description |
|---|---|---|
| GET | /stats | Returns KPI metrics, top intents, and recent conversations. |
| GET | /conversations | Paginated/filterable conversation list. |
| GET | /conversations/:id | Full conversation detail and related tickets. |
Tickets
| Method | Endpoint | Description |
|---|---|---|
| GET | /tickets | Lists tickets with status/priority filters. |
| GET | /tickets/:id | Returns ticket detail with conversation and audit trail. |
| PATCH | /tickets/:id | Updates ticket status and/or priority. |
Intents
| Method | Endpoint | Description |
|---|---|---|
| GET | /intents | Lists intents with usage hit counts. |
| GET | /intents/:id | Retrieves a single intent. |
| POST | /intents | Creates a new intent configuration. |
| PUT | /intents/:id | Updates an existing intent. |
| DELETE | /intents/:id | Deletes an intent. |
Integrations, audit, settings
| Method | Endpoint | Description |
|---|---|---|
| GET | /integrations | Lists tenant integrations with masked credentials. |
| GET | /audit | Paginates audit entries with category filters. |
| GET | /settings | Returns tenant settings + credential preview. |
| PUT | /settings | Updates tenant name/config (merged update). |
Example: update ticket
curl -X PATCH https://platform.watermelonn.app/api/v1/admin/tickets/TICKET_ID \
-H "Authorization: Bearer SUPABASE_ACCESS_TOKEN" \
-H "Content-Type: application/json" \
-d '{"status":"in_progress","priority":"high"}'