PATCH /tickets/{id} — статус, приоритет, тема

Меняет только переданные поля. Каждое изменение — запись в ленте тикета от имени сотрудника ключа, как если бы он нажал кнопку в кабинете. Право — tickets:write.

Закрыть тикет

curl -X PATCH https://app.deskus.ru/api/v1/tickets/T-1042 \
  -H "Authorization: Bearer $DESKUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "closed" }'

Отложить до утра и поднять приоритет

curl -X PATCH https://app.deskus.ru/api/v1/tickets/T-1042 \
  -H "Authorization: Bearer $DESKUS_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "status": "snoozed", "snoozed_until": "2026-10-22T06:00:00Z", "priority": "high" }'

Ответ 200 — тикет после изменений, в поле data.

Поля

Что происходит

• Закрытие — как кнопкой «Закрыть»: если у клиента есть почта, ему уходит письмо «Заявка решена» с кнопкой «Вопрос не решён».

• Изменения приходят подписчикам событием ticket.updated с полем changes (события).

Ошибки

Ответ 422

{
  "error": {
    "code": "validation_error",
    "message": "Для status=snoozed нужно snoozed_until — до какого времени отложить.",
    "details": { "field": "snoozed_until" },
    "request_id": "req_3f9c2a7d1e6b4a8c0d2e5f71"
  }
}

• 422 — неизвестное или лишнее поле, пустое тело, неверный статус или приоритет, время в прошлом.

• 422 с details.missing_fields — для закрытия не заполнены обязательные поля тикета.

• 404 — тикета нет или сотрудника assignee_id нет в компании; 409 — сотруднику отключён доступ.