Skip to content

Erwähnungen

WARNING

Der Erwähnungsendpunkt hängt von den Gruppenberechtigungen ab und davon, ob der Benutzer ein Agent ist. Aus diesem Grund können Tickets verfügbar sein oder auch nicht.

Auflisten

Erforderliche Berechtigung: ticket.agent oder ticket.customer

GET-Anfrage gesendet: /api/v1/mentions

Show response
json
// HTTP-Code 200 OK

{
  "mentions": [
    {
      "id": 2,
      "mentionable_type": "Ticket",
      "mentionable_id": 1,
      "user_id": 3,
      "updated_by_id": 3,
      "created_by_id": 3,
      "created_at": "2021-03-16T08:51:08.985Z",
      "updated_at": "2021-03-16T08:51:08.985Z"
    },
    {
      "id": 3,
      "mentionable_type": "Ticket",
      "mentionable_id": 1,
      "user_id": 4,
      "updated_by_id": 4,
      "created_by_id": 4,
      "created_at": "2021-03-16T08:51:08.986Z",
      "updated_at": "2021-03-16T08:51:08.986Z"
    }
  ]
}

Erstellen

Erforderliche Berechtigung: ticket.agent

POST-Anfrage gesendet: /api/v1/mentions

Show request/response
json
{
  "mentionable_type": "Ticket",
  "mentionable_id": 12
}

Die Erwähnung wird für den Benutzer der aktuellen Sitzung erstellt.

TIP

Wenn Sie andere Benutzer erwähnen oder ein Ticket für sie abbonieren möchten, können Sie dies tun, indem Sie einen zusätzlichen X-On-Behalf-Of-Header in Ihrer Anfrage senden. Sie können entweder die ID des Benutzers oder die E-Mail-Adresse des Benutzers als Wert angeben.

Löschen

Erforderliche Berechtigung: ticket.agent

DELETE-Anfrage gesendet: /api/v1/mentions/{id}

Show response
json
// HTTP-Code 200 OK

{
  "id": 2,
  "mentionable_type": "Ticket",
  "mentionable_id": 1,
  "user_id": 3,
  "updated_by_id": 3,
  "created_by_id": 3,
  "created_at": "2021-03-16T08:51:08.985Z",
  "updated_at": "2021-03-16T08:51:08.985Z"
}