Erwähnungen

WARNING

Um andere Benutzer zu erwähnen, benötigen Sie die Berechtigung ticket.agent sowie mindestens die read Berechtigung für Tickets der Gruppe. Die Berechtigung full ist ebenfalls zulässig. Andernfalls schlägt die Anfrage mit dem HTTP-Status 403 fehl.

Auflisten

Erforderliche Berechtigungen: ticket.agent sowie mindestens read Berechtigung auf die Tickets der Gruppe. Die Berechtigung full ist ebenfalls zulässig

GET-Anfrage gesendet: /api/v1/mentions

Details

// 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 Berechtigungen: ticket.agent sowie mindestens read Berechtigung auf die Tickets der Gruppe. Die Berechtigung full ist ebenfalls zulässig

POST-Anfrage gesendet: /api/v1/mentions

Details

{
  "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 From-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}

Details

// 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"
}