API ReferenceTicket
ticket.create
Type: Mutation · Auth: Workspace-aware
Input
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| customerId | string | Yes | — | ID of the associated customer |
| siteId | string | Yes | — | ID of the associated site |
| serviceOrganizationId | unknown | No | — | ID of the associated service organization |
| billToOrganizationId | unknown | No | — | ID of the associated bill to organization |
| relatedSystemId | string | No | — | ID of the associated related system |
| relatedAssetId | string | No | — | ID of the associated related asset |
| ticketType | enum(service_request, break_fix, installation, inspection, warranty, preventive, other) | Yes | — | Ticket type |
| sourceChannel | enum(portal, phone, email, monitoring, internal, other) | Yes | — | Source channel |
| priority | enum(low, medium, high, critical) | Yes | "medium" | Priority |
| severity | enum(cosmetic, degraded, down, safety) | No | — | Severity |
| status | enum(new, triaged, assigned, in_progress, on_hold, resolved, closed) | Yes | "new" | Status |
| summary | string | Yes | — | Summary |
| symptomDescription | string | No | — | Symptom description |
| triageNotes | string | No | — | Triage notes |
| assignedQueue | string | No | — | Assigned queue |
| assignedUserId | string | No | — | ID of the associated assigned user |
| reportedByContactId | string | No | — | ID of the associated reported by contact |
| category | string | No | — | Category |
| slaDueAt | string.date-time | No | — | Sla due at |
| workspaceId | string | No | — | ID of the associated workspace |
| visibilityMode | enum(global, workspace_local, shared) | Yes | "workspace_local" | Visibility mode |
| contactMethod | enum(phone, email, portal, in_person, chat) | No | — | Contact method |
| estimatedLaborHours | number | No | — | Estimated labor hours |
| relatedTicketId | string.uuid | No | — | ID of the associated related ticket |
Example
{
"customerId": "550e8400-e29b-41d4-a716-446655440000",
"siteId": "550e8400-e29b-41d4-a716-446655440000",
"serviceOrganizationId": null,
"billToOrganizationId": null,
"relatedSystemId": "550e8400-e29b-41d4-a716-446655440000",
"relatedAssetId": "550e8400-e29b-41d4-a716-446655440000",
"ticketType": "service_request",
"sourceChannel": "portal",
"priority": "low",
"status": "new",
"summary": "example",
"visibilityMode": "global"
}