Sign in
latestOpenAPI 3.1.02026-08-109136221.8 KB

abcdc6e980f3

tickets

Update a ticket

Updates an existing ticket with the provided fields

patch/api/v1/tickets/{ticket_id}

Path parameters

ticket_idstring required

Request body

titlestring nullable
descriptionstring nullable
ticket_type'request' | 'incident' | 'question'
priority'low' | 'medium' | 'high' | 'urgent'
status'open' | 'in_progress' | 'pending' | 'pending_reporter' | 'pending_approval' | 'pending_internal_team' | 'pending_third_party' | 'resolved' | 'closed' | 'canceled'
assigneestring nullable

assignee, to unassign pass in _UNASSIGN_

desk_idstring nullable
subdesk_idstring nullable

Subdesk ID to move ticket to (must be in same desk)

notification_reply_idstring nullable
custom_fieldsobject nullable

Custom field values for the current or new desk

ticket_metadataobject nullable

Additional metadata for the ticket

attachment_idsstring[] nullable

List of attachment IDs to link to this ticket

created_atstring date-time nullable

Optional creation timestamp override. Used for backfilling original ITSM timestamps during re-evaluation.

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
publish_eventsboolean

Whether to publish domain events for this ticket update. Set to False to suppress event publishing (useful for bulk imports or migrations). Defaults to True. This suppresses ALL events including status changes, assignee changes, and survey triggers.

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