Priorities

List

Required permission: admin.object or ticket.agent orticket.customer

GET-Request sent: /api/v1/ticket_priorities

Show response

// HTTP-Code 200 OK

[
  {
    "id": 1,
    "name": "1 low",
    "default_create": false,
    "ui_icon": "low-priority",
    "ui_color": "low-priority",
    "note": null,
    "active": true,
    "updated_by_id": 1,
    "created_by_id": 1,
    "created_at": "2021-11-03T11:51:13.559Z",
    "updated_at": "2021-11-03T11:51:13.572Z"
  },
  {
    "id": 2,
    "name": "2 normal",
    "default_create": true,
    "ui_icon": null,
    "ui_color": null,
    "note": null,
    "active": true,
    "updated_by_id": 1,
    "created_by_id": 1,
    "created_at": "2021-11-03T11:51:13.570Z",
    "updated_at": "2021-11-03T11:51:13.570Z"
  },
  {
    "id": 3,
    "name": "3 high",
    "default_create": false,
    "ui_icon": "important",
    "ui_color": "high-priority",
    "note": null,
    "active": true,
    "updated_by_id": 1,
    "created_by_id": 1,
    "created_at": "2021-11-03T11:51:13.579Z",
    "updated_at": "2021-11-03T11:51:13.579Z"
  }
]

Show

Required permission: admin.object or ticket.agent orticket.customer

GET-Request sent: /api/v1/ticket_priorities/{id}

Show response

// HTTP-Code 200 OK

{
  "id": 3,
  "name": "3 high",
  "default_create": false,
  "ui_icon": "important",
  "ui_color": "high-priority",
  "note": null,
  "active": true,
  "updated_by_id": 1,
  "created_by_id": 1,
  "created_at": "2021-11-03T11:51:13.579Z",
  "updated_at": "2021-11-03T11:51:13.579Z"
}

Create

Required permission: admin.object

POST-Request sent: /api/v1/ticket_priorities

Details

{
  "name": "4 disaster",
  "default_create": false,
  "ui_icon": "important",
  "ui_color": "high-priority",
  "note": "Added via API for disasterious situations."
}

Update

Required permission: admin.object

PUT-Request sent: /api/v1/ticket_priorities/{id}

Details

{
  "ui_icon": "",
  "ui_color": "",
  "note": "Adjusted via API - not so important"
}

Delete

Required permission: admin.object

DELETE-Request sent: /api/v1/ticket_priorities/{id}

DANGER

This is a permanent removal

Please note that removing priorities cannot be undone.

Removing ticket priorities with references in tickets is not possible via API - this will be indicated by "error": "Can't delete, object has references.". This is not a bug.

Consider either setting said priority to active: false or adjust all tickets with the to remove priority to another priority.

Show response

Response:

// HTTP-Code 200 OK

{}