APIGroups

List groups

List groups in the organization.

GET
/groups

List groups in the organization.

Authorization

ApiKeyAuth
headerAuthorizationBearer <token>

Bearer token authentication. Send an API key (a saai_api_-prefixed token) as Authorization: Bearer <token>.

Required permission

view_users

Query Parameters

offset?integer

Number of items to skip before returning results.

Formatint32
Range0 <= value
Default0
limit?integer

Maximum number of items to return per page.

Formatint32
Range0 <= value <= 256
Default10
search?string

Free-text search term to filter results by name.

Lengthlength <= 255
sort_by?string

Field to sort groups by.

Default"created_at"
Value in"created_at""name"
sort_order?string

Direction to sort results.

Default"desc"
Value in"asc""desc"

Response Body

The request has succeeded.

application/json
  1. response

A page of results together with its paging information.

items*array<>

The items in this page.

meta*

Paging information for a list response.

curl -X GET "https://example.com/groups"
{  "items": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "name": "string",      "created_at": "2019-08-24T14:15:22Z"    }  ],  "meta": {    "total": 0,    "offset": 0,    "limit": 0  }}