Groups
The
groups namespace provides API methods to retrieve all or specific user groups. This page covers the following API methods:
Returns all groups. Requires site admin access.
Parameters
Schema
 page integer
Number of page to return (default: first page) |
per_page integer
Maximum number of groups to return (supported: 15, 25, 50, 100; default: 100) |
expands string
Comma-separated list of expands to return. |
"page": {
"type": "integer",
"format": "int64",
"description": "Number of page (default: first page)."
},
"per_page": {
"type": "integer",
"format": "int64",
"enum": [
15,
25,
50,
100
],
"description": "Maximum number of items to return per page (default: 100)."
},
"expands": {
"type": "string",
"description": "Comma-separated list of expands to return."
}
This method supports the following expands so you can automatically include additional information for referenced objects:
users
GET /api/v1/groups
200 OK
{
"page": 1,
"prev_page": null,
"next_page": null,
"last_page": 1,
"per_page": 100,
"total": 4,
"result": [
{
"id": 1,
"name": "QA",
"members": [1, 2, 3, 4, 5, ..],
"created_at": "..",
"created_by": 2,
"updated_at": null,
"updated_by": null
},
{
"id": 2,
"name": "Dev",
"members": [3, 4, 5, ..],
"created_at": "..",
"created_by": 2,
"updated_at": null,
"updated_by": null
},
..
],
"expands": {
..
}
}
// Get first 100 groups
GET /api/v1/groups
// Get second result page (pagination)
GET /api/v1/groups?page=2
// Get groups and include user details
GET /api/v1/groups?expands=users
Returns a single group. Requires site admin access.
 group_id id required
ID of the group to return. |
Parameters
Schema
expands string
Comma-separated list of expands to return. |
"expands": {
"type": "string",
"description": "Comma-separated list of expands to return."
}
This method supports the following expands so you can automatically include additional information for referenced objects:
users
GET /api/v1/groups/1
200 OK
{
"result": {
"id": 1,
"name": "QA",
"members": [1, 2, 3, 4, 5, ..],
"created_at": "..",
"created_by": 2,
"updated_at": null,
"updated_by": null
},
"expands": {
..
}
}
// Get the group with ID 5
GET /api/v1/groups/5
// Get a group and include user details
GET /api/v1/groups/1?expands=users
Last modified 6mo ago