# Tickets

## Introduction

A ticket is a resource type on the platform. It allows users to register and track on-field deployments, incidents or requests (required needs).

## Comprehensive API actions

### Updating a ticket

Please note that the following fields cannot be modified:

* `identifier`
* `type`
* `reporter`
* `entity`: If the ticket does not contain the entity, it can be updated.

Please be advised that the dates will be updated by the platform internally, depending on the status of the ticket. Please note that these dates cannot be modified.

* `creationDate`
* `assignedDate`
* `answeredDate`
* `updatedDate`
* `restorationDate`
* `resolutionDate`
* `closedDate`

### Searching tickets

The OpenGate API query enables the retrieval of the list of tickets.

The results can be obtained in two different formats, as detailed in the HTTP Header Options:
* JSON Format (default)
* CSV Format

## API specification

{{< openapi src="tickets.yaml" >}}