Skip to main content

Обновить заявку

PUT /tickets/:ticket_id/


Пример URL

https://домен_системы/api/v2/tickets/123/


PATH-параметры

ПараметрТипОбязательныйОписание
ticket_idчислоДаТехнический ID заявки

Параметры тела запроса (JSON)

ПараметрТипОбязательныйОписание
pidчислоНетID родительской заявки
titleстрокаНетТема (название) заявки
sla_dateдатаНетДата и время SLA (DD.MM.YYYY H:S), для указании пустого значение - 0
sla_policy_idчислоНетID SLA-плана
freeze_dateдатаНетДата и время, до которого заявка будет заморожена (DD.MM.YYYY H:S)
status_idстрокаНетID статуса заявки
priority_idчислоНетID приоритета заявки
type_idчислоНетID типа заявки
department_idчислоНетID департамента заявки
ticket_lockчисло
boolean
НетБлокировка заявки
(true или 1 - заблокирована, false или 0 - разблокирована)
owner_idчислоНетID исполнителя заявки
user_idчислоНетID владельца (клиента) заявки
ccмассивНетАдресаты копий письма
bccмассивНетАдресаты скрытых копий письма
followersмассивНетСписок пользователей следящих за заявкой, тип пользователя должен быть сотрудником
custom_fieldsобъектНетИндивидуальные поля заявки
tagsмассивНетСписок меток

Пример тела запроса (JSON)

{
"title": "Тестовая заявка",
"sla_date":"01.01.2027 00:00", // Чтобы убрать значения, необходимо указать ""
"sla_policy_id":"1",
"status_id":"open",
"priority_id":1,
"type_id":1,
"department_id":1,
"ticket_lock":false,
"owner_id": 1,
"user_id": 1,
"cc":["email@example.com","email2@example.com"],
"bcc":["email@example.com","email2@example.com"],
"followers":[1],
"custom_fields": {
"96": "Значение поля с типом (Текстовое поле)", // Пример для поля c типом "Текстовое поле" (ID = 96), для установки пустого значения указать ""
"97": "Значение поля с типом (Текстовая область)", // Пример для поля с типом "Текстовая область" (ID = 97), для установки пустого значения указать ""
"98": "1", // Пример поля с типом "Числовое поле" (ID = 98), для установки пустого значения указать ""
"99": "192", // Пример для поля с типом "Выпадающий список" (ID = 99), необходимо указать ID значений из поля, для установки пустого значения указать ""
"100":{ // Пример поля с типом "Связанные поля" (ID = 100)
"1": 198, // Значение ID-поля первого уровня
"2": 204 // Значение ID-поля второго уровня
},
// "100":{
// "1": 0, // Структура для указания пустового значения с типом "Связанные поля"
// }
"101": "01.01.2027", // Пример для поля с типом "Дата" (ID = 101), для установки пустого значения указать ""
"102": "09:00", // Пример для поля с типом "Время" (ID = 102), для установки пустого значения указать ""
"103": "example@mail.com", // Пример для поля с типом "Регулярное выражение" (ID = 103), для установки пустого значения указать ""
"104": "1", // Пример для поля с типом "Флажок (чекбокс)" (ID = 104), для установки пустого значения указать ""
"105": "1", // Пример для поля с типом "Кнопка" (ID = 105), для установки пустого значения указать ""
"106": "45928", // Пример для поля с типом "Мультикнопка" (ID = 106), необходимо указать ID значений из поля, для установки пустого значения указать ""
},
"tags":[1,2]
}

Пример ответа
{
"data": {
"id": 123,
"pid": 0,
"unique_id": "ABC-123",
"date_created": "2025-11-21 09:40:47",
"date_updated": "2025-11-21 10:33:34",
"title": "Тестовая заявка",
"source": "system",
"status_id": "open",
"priority_id": 1,
"type_id": 1,
"department_id": 1,
"department_name": "Отдел поддержки",
"owner_id": 1,
"owner_name": "Administrator",
"owner_lastname": "",
"owner_email": "email@example.com",
"user_id": 1,
"user_name": "user1",
"user_lastname": "",
"user_email": "email4@example.com",
"cc": [
"email@example.com",
"email2@example.com"
],
"bcc": [
"email@example.com",
"email2@example.com"
],
"followers": [
1
],
"ticket_lock": 0,
"sla_date": "01.01.2026 00:00",
"sla_flag": 0,
"freeze_date": null,
"freeze": 0,
"viewed_by_staff": 1,
"viewed_by_client": 0,
"rate": "",
"rate_comment": "",
"rate_date": "",
"deleted": 0,
"custom_fields": [
{
"id": 96,
"field_type": "text",
"field_value": "Значение поля с типом (Текстовое поле)"
},
{
"id": 97,
"field_type": "textarea",
"field_value": "Значение поля с типом (Текстовая область)"
},
{
"id": 98,
"field_type": "number",
"field_value": "1"
},
{
"id": 99,
"field_type": "select",
"field_value": {
"id": 192,
"name": {
"ru": "Значение 1",
"en": "",
"ua": ""
}
}
},
{
"id": 100,
"field_type": "hierarchy",
"field_value": {
"1": {
"id": 198,
"name": {
"ru": "Родительский элемент первого уровня"
}
},
"2": {
"id": 204,
"name": {
"ru": "Дочерний элемент второго уровня"
}
}
}
},
{
"id": 101,
"field_type": "date",
"field_value": "01.01.2027"
},
{
"id": 102,
"field_type": "time",
"field_value": "09:00"
},
{
"id": 103,
"field_type": "regex",
"field_value": "example@mail.com"
},
{
"id": 104,
"field_type": "checkbox",
"field_value": 1
},
{
"id": 105,
"field_type": "button",
"field_value": 1
},
{
"id": 106,
"field_type": "multi_button",
"field_value": {
"id": 45928,
"name": {
"ru": "Значение кнопки с ID 45928"
}
}
}
],
"tags": [
"1",
"2"
],
"jira_issues": []
}
}