Get Group Count (POST)
Queries for groups using a list of parameters and retrieves the count.
Method
POST /group/count
Parameters
Request Body
A JSON object with the following properties:
Name | Description |
---|---|
id | Filter by the id of the group. |
idIn | Filter by a JSON array of group ids. |
name | Filter by the name of the group. |
nameLike | Filter by the name that the parameter is a substring of. |
type | Filter by the type of the group. |
member | Only retrieve groups which the given user id is a member of. |
memberOfTenant | Only retrieve groups which are members of the given tenant. |
sortBy | Sort the results lexicographically by a given criterion. Valid values are
id , name and type .
Must be used in conjunction with the sortOrder parameter. |
sortOrder | Sort the results in a given order. Values may be asc for ascending order or desc for descending order.
Must be used in conjunction with the sortBy parameter. |
Result
A JSON object that contains the count as the only property.
Name | Value | Description |
---|---|---|
count | Number | The number of matching groups. |
Response Codes
Code | Media type | Description |
---|---|---|
200 | application/json | Request successful. |
400 | application/json | Returned if some of the query parameters are invalid, for example if a sortOrder parameter is supplied, but no sortBy is specified. See the Introduction for the error response format. |
Example
Request
POST /group/count?name=Sales
Response
Status 200.
{"count": 1}