v1

latestOpenAPI 3.0.32026-07-131670112.4 KB

Tickets

Create ticket / incident

Tickets and incidents are the same object. Every record in this table is accessible via both /v1/tickets and the real-time /v1/incidents layer — same NocoDB row, same ID, same fields. No data is duplicated.

Use /v1/tickets for helpdesk, ITSM, or async workflows
Use /v1/incidents + SSE for real-time dispatch, ops war rooms, or alert routing
The source field (api, email, webhook, alert) and priority together imply context — neither endpoint enforces a use case on the caller

Creates a new record. title is required. Defaults: status=open, priority=normal, source=api. A customer_token is generated automatically — use it to share the public status page at https://schedkit.net/incidents/status/:token. A real-time SSE event (incident.created) is broadcast to all connected staff.

post/v1/tickets

Request body

titlestring required

descriptionstring

priority'low' | 'normal' | 'high' | 'urgent'

source'api' | 'email' | 'webhook' | 'alert'

Origin of the record. Use alert for automated incident creation, email for inbound support, api for programmatic creation.

source_refstring

External reference ID (e.g. email message ID, alert ID)

latnumber nullable

Incident latitude

lngnumber nullable

Incident longitude

location_namestring nullable

Human-readable location name

customer_emailstring nullable

Email to notify — if set, confirmation goes here instead of the creator

customer_namestring nullable

Customer display name for the email

org_idinteger nullable

Org this ticket belongs to — determines email branding

Response

Created ticket/incident

Idinteger

titlestring

statusstring

prioritystring

sla_due_atstring nullable

sla_breachedboolean

sla_status'ok' | 'warning' | 'breached'

customer_tokenstring

Magic token for the public customer status page

customer_status_urlstring

Full URL to public customer status page

latnumber nullable

lngnumber nullable

location_namestring nullable

Example response

{
  "Id": 42,
  "title": "Water main pressure drop",
  "description": "Pressure dropped below threshold at Site Alpha.",
  "status": "open",
  "priority": "urgent",
  "source": "alert",
  "source_ref": "sensor-ops-991",
  "user_id": 7,
  "sla_due_at": "2026-03-15T19:00:00Z",
  "sla_breached": false,
  "sla_status": "warning",
  "customer_token": "cus_tok_abc123xyz",
  "customer_status_url": "https://schedkit.net/incidents/status/cus_tok_abc123xyz",
  "lat": 35.4676,
  "lng": -97.5164,
  "location_name": "Site Alpha"
}