Skip to main content

Base path

https://platform.watermelonn.app/api/v1/admin
All routes require a Supabase access token in the Authorization header.

Auth and onboarding

MethodEndpointDescription
GET/auth/meReturns linked tenant and role for current user.
POST/auth/onboardCreates tenant and links current user as owner.

Dashboard and operations

MethodEndpointDescription
GET/statsReturns KPI metrics, top intents, and recent conversations.
GET/conversationsPaginated/filterable conversation list.
GET/conversations/:idFull conversation detail and related tickets.

Tickets

MethodEndpointDescription
GET/ticketsLists tickets with status/priority filters.
GET/tickets/:idReturns ticket detail with conversation and audit trail.
PATCH/tickets/:idUpdates ticket status and/or priority.

Intents

MethodEndpointDescription
GET/intentsLists intents with usage hit counts.
GET/intents/:idRetrieves a single intent.
POST/intentsCreates a new intent configuration.
PUT/intents/:idUpdates an existing intent.
DELETE/intents/:idDeletes an intent.

Integrations, audit, settings

MethodEndpointDescription
GET/integrationsLists tenant integrations with masked credentials.
GET/auditPaginates audit entries with category filters.
GET/settingsReturns tenant settings + credential preview.
PUT/settingsUpdates 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"}'