Gruppe

INFO

• Bitte beachten Sie, dass follow_up_possible möglicherweise nicht wie erwartet funktioniert. Die möglichen Werte sind yes oder new_ticket!
• Wenn Sie Untergruppen erstellen oder aktualisieren wollen, verwenden Sie :: als Trennzeichen für die Namen. Sie müssen auch die gesamte Hierarchie im Namen nennen. Beispiel: Verkauf::Europa::Süd

Auflisten

Erforderliche Berechtigung: admin.group

GET-Anfrage gesendet: /api/v1/groups

Show response

// HTTP-Code 200 OK

[
  {
    "id": 1,
    "signature_id": 1,
    "email_address_id": null,
    "name": "Sales",
    "assignment_timeout": null,
    "follow_up_possible": "yes",
    "follow_up_assignment": true,
    "active": true,
    "note": "Standard Group/Pool for Tickets.",
    "updated_by_id": 1,
    "created_by_id": 1,
    "created_at": "2021-11-03T11:51:13.449Z",
    "updated_at": "2021-11-03T11:57:16.357Z",
    "user_ids": [
      3,
      4,
      5
    ]
  },
  {
    "id": 2,
    "signature_id": null,
    "email_address_id": null,
    "name": "Support::2nd Level",
    "assignment_timeout": null,
    "follow_up_possible": "yes",
    "follow_up_assignment": true,
    "active": true,
    "note": null,
    "updated_by_id": 1,
    "created_by_id": 1,
    "created_at": "2021-11-03T11:57:15.802Z",
    "updated_at": "2021-11-03T11:57:16.361Z",
    "user_ids": [
      3,
      4,
      5
    ]
  },
  {
    "id": 3,
    "signature_id": null,
    "email_address_id": null,
    "name": "IT Internal",
    "assignment_timeout": null,
    "follow_up_possible": "yes",
    "follow_up_assignment": true,
    "active": true,
    "note": null,
    "updated_by_id": 1,
    "created_by_id": 1,
    "created_at": "2021-11-03T11:57:15.807Z",
    "updated_at": "2021-11-03T11:57:16.365Z",
    "user_ids": [
      3,
      4,
      5
    ]
  }
]

Anzeigen

Erforderliche Berechtigung: admin.group

GET-Anfrage gesendet: /api/v1/groups/{id}

Show response

// HTTP-Code 200 OK

{
  "id": 2,
  "signature_id": null,
  "email_address_id": null,
  "name": "2nd Level",
  "assignment_timeout": null,
  "follow_up_possible": "yes",
  "follow_up_assignment": true,
  "active": true,
  "note": null,
  "updated_by_id": 1,
  "created_by_id": 1,
  "created_at": "2021-11-03T11:57:15.802Z",
  "updated_at": "2021-11-03T11:57:16.361Z",
  "user_ids": [
    3,
    4,
    5
  ]
}

Erstellen

Erforderliche Berechtigung: admin.group

POST-Anfrage gesendet: /api/v1/groups

Show request/response

{
  "name": "Amazing Group",
  "signature_id": 1,
  "email_address_id": 3,
  "assignment_timeout": 180,
  "follow_up_possible": "new_ticket",
  "follow_up_assignment": false,
  "active": true,
  "note": "Look at my group, my group is amazing!"
}

Aktualisierung

Erforderliche Berechtigung: admin.group

PUT-Anfrage gesendet: /api/v1/groups/{id}

Show request/response

{
  "name": "Amazing Group",
  "signature_id": 1,
  "email_address_id": 3,
  "assignment_timeout": 0,
  "follow_up_possible": "new_ticket",
  "follow_up_assignment": true,
  "active": true,
  "note": "Look at my group, my group is amazing!"
}

Löschen

Erforderliche Berechtigung: admin.group

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

DANGER

Dies ist eine dauerhafte Entfernung

Bitte beachten Sie, dass das Entfernen von Gruppen nicht rückgängig gemacht werden kann.

Das Entfernen von Organisationen mit Referenzen in z.B. Aktivitäts-Verläufen oder Tickets ist über die API nicht möglich - dies wird angezeigt durch "Fehler": "Kann nicht gelöscht werden, Objekt hat Referenzen.". Dies ist kein Fehler.

Erwägen Sie stattdessen, betroffene Gruppen auf inaktiv zu setzen oder sicherzustellen, dass alle bestehenden Tickets in neue Gruppen verschoben werden.

Show response

// HTTP-Code 200 OK

{}