latestOpenAPI 3.1.02026-08-109136221.8 KB
abcdc6e980f3
tickets
Create a new ticket
Creates a new support ticket in the system
post/api/v1/tickets/
Request body
titlestring required
descriptionstring nullable
ticket_type'request' | 'incident' | 'question' required
priority'low' | 'medium' | 'high' | 'urgent' required
source'slack' | 'harmony' | 'teams' | 'freshservice' | 'jsm' | 'solarwinds' | 'email' | 'siit'
reporterstring required
assigneestring nullable
desk_idstring required
attachment_idsstring[]
custom_fieldsobject nullable
Custom field values for this desk
ticket_metadataobject nullable
Additional metadata for the ticket
created_atstring date-time nullable
Optional creation timestamp. If not provided, current time will be used. Used for preserving original ITSM timestamps during import.
related_asset_idsstring[] nullable
List of asset IDs (UUIDs) to associate with this ticket
publish_eventsboolean
Whether to publish domain events for this ticket creation. Set to False to suppress event publishing (useful for bulk imports or migrations). Defaults to True.
thread_idstring uuid nullable
Optional thread ID to associate with this ticket. If not provided a new thread will be created.
Response
Successful Response
idstring required
titlestring required
descriptionstring nullable
ticket_type'request' | 'incident' | 'question' required
priority'low' | 'medium' | 'high' | 'urgent' required
source'slack' | 'harmony' | 'teams' | 'freshservice' | 'jsm' | 'solarwinds' | 'email' | 'siit' required
status'open' | 'in_progress' | 'pending' | 'pending_reporter' | 'pending_approval' | 'pending_internal_team' | 'pending_third_party' | 'resolved' | 'closed' | 'canceled' required
reporterstring required
created_bystring required
assigneestring nullable
desk_idstring required
subdesk_idstring required
created_atstring date-time required
updated_atstring date-time required
custom_fieldsobject nullable required
Custom field values for the current desk
ticket_metadataobject nullable
Additional metadata for the ticket
related_asset_idsstring[] nullable
List of asset IDs (UUIDs) associated with this ticket
thread_idstring uuid nullable
Thread ID for the ticket conversation
response_sla_deadlinestring date-time nullable
response_sla_completed_atstring date-time nullable
resolution_sla_deadlinestring date-time nullable
resolution_sla_completed_atstring date-time nullable