Common ModelsTickets

The Ticket object

The Ticket object is used to represent a ticket, issue, task or case.

idstringOptionalRead-onlyformat: "uuid"
remote_idstring or nullOptional
The third-party API ID of the matching object.
created_atdatetimeOptionalRead-only
The datetime that this object was created by Merge.
modified_atdatetimeOptionalRead-only
The datetime that this object was modified by Merge.
namestring or nullOptional
The ticket's name.
assigneeslist of stringsOptional
The individual `Users` who are assigned to this ticket. This does not include `Users` who just have view access to this ticket. To fetch all `Users` and `Teams` that can access the ticket, use the `GET /tickets/{ticket_id}/viewers` [endpoint](https://docs.merge.dev/ticketing/tickets/#tickets_viewers_list).
assigned_teamslist of stringsOptional
The `Teams` that are assigned to this ticket. This does not include `Teams` who just have view access to this ticket. To fetch all `Users` and `Teams` that can access this ticket, use the `GET /tickets/{ticket_id}/viewers` [endpoint](https://docs.merge.dev/ticketing/tickets/#tickets_viewers_list).
creatorstring or nullOptionalformat: "uuid"
The user who created this ticket.
due_datedatetime or nullOptional
The ticket's due date.
statusenum or nullOptional
The current status of the ticket. * `OPEN` - OPEN * `CLOSED` - CLOSED * `IN_PROGRESS` - IN_PROGRESS * `ON_HOLD` - ON_HOLD
Allowed values:
descriptionstring or nullOptional
The ticket’s description. HTML version of description is mapped if supported by the third-party platform.
collectionslist of stringsOptional
The `Collections` that this `Ticket` is included in.
ticket_typestring or nullOptional
The sub category of the ticket within the 3rd party system. Examples include incident, task, subtask or to-do.
accountstring or nullOptionalformat: "uuid"
The account associated with the ticket.
contactstring or nullOptionalformat: "uuid"
The contact associated with the ticket.
parent_ticketstring or nullOptionalformat: "uuid"
The ticket's parent ticket.
attachmentslist of stringsOptional
access_levelenum or nullOptional
The description of who is able to access a given ticket, or where access is inherited from. * `COMPANY` - COMPANY * `PUBLIC` - PUBLIC * `PRIVATE` - PRIVATE * `COLLECTION` - COLLECTION
Allowed values:
permissionslist of objectsOptionalRead-only
tagslist of stringsOptional
roleslist of stringsOptional
ticket_urlstring or nullOptionalformat: "uri"<=2000 characters
The 3rd party url of the Ticket.
priorityenum or nullOptional
The priority or urgency of the Ticket. * `URGENT` - URGENT * `HIGH` - HIGH * `NORMAL` - NORMAL * `LOW` - LOW
Allowed values:
remote_created_atdatetime or nullOptional
When the third party's ticket was created.
remote_updated_atdatetime or nullOptional
When the third party's ticket was updated.
completed_atdatetime or nullOptional
When the ticket was completed.
remote_was_deletedbooleanOptionalRead-only
Indicates whether or not this object has been deleted in the third party platform. Full coverage deletion detection is a premium add-on. Native deletion detection is offered for free with limited coverage. [Learn more](https://docs.merge.dev/integrations/hris/supported-features/).
field_mappingsobject or nullOptionalRead-only
remote_datalist of objects or nullOptionalRead-only
remote_fieldslist of objectsOptionalRead-only