Support

Programmatic access to support tickets and the live system status banner that powers the in-app Help & support page.

Create a Ticket

POST /v1/support/tickets

Creates a ticket and emails it to support@rymi.live via Resend (best-effort — the ticket persists even if the email fails).

Request Body

Field	Type	Required	Description
subject	string	yes	3–200 chars
category	enum	yes	One of billing, voice_quality, telephony, agent_publishing, api_sdk, account, other
description	string	yes	10–5,000 chars
call_id	string	no	Optional related call id for context
contact_email	string	no	Reply-to address; defaults to the user's account email

Response 200

{
  "ticket": {
    "id": "tkt_...",
    "status": "open",
    "created_at": "..."
  },
  "email_delivered": true,
  "email_reason": null
}

email_delivered: false indicates the ticket was saved but the support inbox email failed (e.g. RESEND_API_KEY missing). email_reason carries the upstream message.

---

List Your Tickets

GET /v1/support/tickets

Query Parameters

Parameter	Type	Default	Description
limit	integer	50	Max records (cap 200)
offset	integer	0	Records to skip

Response 200

{
  "data": [
    {
      "id": "tkt_...",
      "subject": "Webhook signatures failing",
      "category": "api_sdk",
      "description": "...",
      "call_id": null,
      "status": "open",
      "contact_email": "engineer@acme.com",
      "created_at": "...",
      "updated_at": "..."
    }
  ],
  "total": 1,
  "offset": 0,
  "limit": 50
}

status	Meaning
open	Newly created, awaiting triage
awaiting_user	Rymi has replied; ball is in your court
in_progress	Rymi is working on it
resolved	Resolved by Rymi
closed	Closed without resolution

---

System Status

GET /v1/support/status

Returns the current operational status banner. Powers the live "All systems operational / Degraded / Outage" badge on the in-app Help → System status tab.

Response 200

{
  "status": "operational",
  "message": null,
  "updated_at": "2026-04-01T10:00:00Z"
}

status	Meaning
operational	All systems normal
degraded	Partial degradation — see message
outage	Major outage — see message

For component-level health and incident history, see status.rymi.live.