Skip to main content
PUT
/
v2
/
tickets
/
{id}
Update Ticket
curl --request PUT \
  --url https://public.api.serval.com/v2/tickets/{id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "name": "<string>",
  "description": "<string>",
  "statusId": "<string>",
  "priorityId": "<string>",
  "assignedToUserId": "<string>",
  "labelIds": [
    "<string>"
  ],
  "slaStartedAt": "2023-11-07T05:31:56Z",
  "slaBreachesAt": "2023-11-07T05:31:56Z",
  "escalationLevel": "AI",
  "requesterUserId": "<string>",
  "dueDate": {
    "year": 123,
    "month": 123,
    "day": 123
  },
  "waitUntil": "2023-11-07T05:31:56Z",
  "nameTranslations": {},
  "descriptionTranslations": {}
}
'
{
  "data": {
    "id": "<string>",
    "friendlyIdentifier": "<string>",
    "teamId": "<string>",
    "name": "<string>",
    "description": "<string>",
    "createdAt": "2023-11-07T05:31:56Z",
    "completedAt": "2023-11-07T05:31:56Z",
    "escalatedAt": "2023-11-07T05:31:56Z",
    "createdByUserId": "<string>",
    "assignedToUserId": "<string>",
    "requesterUserId": "<string>",
    "statusId": "<string>",
    "escalationLevel": "AI",
    "priorityId": "<string>",
    "slaStartedAt": "2023-11-07T05:31:56Z",
    "slaBreachesAt": "2023-11-07T05:31:56Z",
    "labelIds": [
      "<string>"
    ],
    "type": "TICKET_TYPE_UNSPECIFIED",
    "dueDate": {
      "year": 123,
      "month": 123,
      "day": 123
    },
    "isOverdue": true,
    "childTicketIds": [
      "<string>"
    ],
    "linkedTicketIds": [
      "<string>"
    ],
    "duplicateTicketIds": [
      "<string>"
    ],
    "dependsOnTicketIds": [
      "<string>"
    ],
    "parentTicketId": "<string>",
    "conversationThreadTicketIds": [
      "<string>"
    ],
    "conversationThreadParentTicketId": "<string>",
    "nameTranslations": {},
    "descriptionTranslations": {}
  }
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
id
string
required

Body

application/json
​
name
string | null
​
description
string | null
​
statusId
string | null
​
priorityId
string | null
​
assignedToUserId
string | null
​
labelIds
string[]
​
slaStartedAt
string<date-time> | null

A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z").

​
slaBreachesAt
string<date-time> | null

A timestamp in RFC 3339 format (e.g., "2025-01-15T01:30:15Z").

​
escalationLevel
enum<string> | null
deprecated

Deprecated: escalation level is now automatically managed by assignment. Assigning to a user escalates to HUMAN; assigning to the system user de-escalates to AI. This field still works but will be removed in a future API version.

Available options:
AI,
HUMAN
​
requesterUserId
string | null
​
dueDate
due_date · object

Optional. Due date (date only, no time component). Set to a date to update the due date. Set to an empty/zero date (year=0, month=0, day=0) to clear the due date.

​
waitUntil
string<date-time> | null

Optional. Timestamp until which this ticket is waiting. Set to a future timestamp to block, set to a zero/past timestamp to clear.

​
nameTranslations
name_translations · object

Upserts the provided translations (only touches languages included). A language with empty string value deletes that translation. When nil (not sent), existing translations are unchanged.

​
descriptionTranslations
description_translations · object

Response

Success

​
data
data · object