Group

List

Required permission:

  • admin.group (can read all groups)

Request:

GET /api/v1/groups

Response:

Status: 200 Ok

[
  {
    "id": 123,
    "name": "Group 1",
    "signature_id": 123,
    "email_address_id": 123,
    "assignment_timeout": 180,
    "follow_up_possible": "yes",
    "follow_up_assignment": true,
    "active": true,
    "note": "some note",
    "updated_at": "2016-08-16T07:55:42.119Z",
    "created_at": "2016-08-16T07:55:42.119Z"
  },
  {
    "id": 124,
    "name": "Group 2",
    "signature_id": 123,
    "email_address_id": 123,
    "assignment_timeout": 180,
    "follow_up_possible": "no",
    "follow_up_assignment": false,
    "active": true,
    "note": "some note",
    "updated_at": "2016-08-16T07:55:42.119Z",
    "created_at": "2016-08-16T07:55:42.119Z"
  },
]

Show

Required permission:

  • admin.group (can read all groups)

Request:

GET /api/v1/groups/{id}

Response:

Status: 200 Ok

{
 "id": 123,
 "name": "Group 1",
 "signature_id": 123,
 "email_address_id": 123,
 "assignment_timeout": 180,
 "follow_up_possible": "yes",
 "follow_up_assignment": true,
 "active": true,
 "note": "some note",
 "updated_at": "2016-08-16T07:55:42.119Z",
 "created_at": "2016-08-16T07:55:42.119Z"
}

Create

Required permission:

  • admin.group

Request:

POST /api/v1/groups


{
 "name": "Group 1",
 "signature_id": 123,
 "email_address_id": 123,
 "assignment_timeout": 180,
 "follow_up_possible": "yes",
 "follow_up_assignment": true,
 "active": true,
 "note": "some note"
}

Response:

Status: 201 Created

{
 "id": 123,
 "name": "Group 1",
 "signature_id": 123,
 "email_address_id": 123,
 "assignment_timeout": 180,
 "follow_up_possible": "yes",
 "follow_up_assignment": true,
 "active": true,
 "note": "some note",
 "updated_at": "2016-08-16T07:55:42.119Z",
 "created_at": "2016-08-16T07:55:42.119Z"
}

Update

Required permission:

  • admin.group

Request:

PUT /api/v1/groups/{id}

{
 "id": 123,
 "name": "Group 1",
 "signature_id": 123,
 "email_address_id": 123,
 "assignment_timeout": 180,
 "follow_up_possible": "yes",
 "follow_up_assignment": true,
 "active": true,
 "note": "some note"
}

Response:

Status: 200 Ok

{
 "id": 123,
 "name": "Group 1",
 "signature_id": 123,
 "email_address_id": 123,
 "assignment_timeout": 180,
 "follow_up_possible": "yes",
 "follow_up_assignment": true,
 "active": true,
 "note": "some note",
 "updated_at": "2016-08-16T07:55:42.119Z",
 "created_at": "2016-08-16T07:55:42.119Z"
}

Delete

Required permission:

  • admin.group (only if no references in history tables and tickets exist)

Request:

DELETE /api/v1/groups/{id}

Response:

Status: 200 Ok

{}