Groups

List IMS groups

Workspaces API

Version: 1.0

Preview

Returns a list of available IMS groups for the organization

Preview API

This API functionality is currently in preview. Preview APIs may be unstable within the preview period: they may change without notice. You must set the header API-Preview: opt-in to opt into using this functionality.

Parameters

authorizationstring

Required

Set to "opt-in" to be able to use this API.

Set to "opt-in" to be able to use this API. This header is being deprecated. Please use the API-Preview header.

org_iduuid

Required

Returns

200

Successful Response

idstring

is_federated_groupboolean

namestring

Endpoint

GET

/workspace/orgs/{org_id}/ims/groups

Request

cURL

​

curl -X GET 'https://{service_host}/workspace/orgs/{org_id}/ims/groups' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>'

Response

[
  {
    "id": "string",
    "is_federated_group": true,
    "name": "string"
  }
]

---

Get IMS users

Workspaces API

Version: 1.0

Preview

Returns a list of users in an IMS organization, filtered by the first characters of their email address

Preview API

This API functionality is currently in preview. Preview APIs may be unstable within the preview period: they may change without notice. You must set the header API-Preview: opt-in to opt into using this functionality.

Parameters

authorizationstring

Required

Set to "opt-in" to be able to use this API.

Set to "opt-in" to be able to use this API. This header is being deprecated. Please use the API-Preview header.

org_iduuid

Required

emailstring

Required

>= 9 chars

Example: "ilike:foo*"

Returns

200

Successful Response

emailstring

full_namestring

Endpoint

GET

/workspace/orgs/{org_id}/ims/users

Request

cURL

​

curl -X GET 'https://{service_host}/workspace/orgs/{org_id}/ims/users' \
  -H 'Authorization: Bearer <ACCESS_TOKEN>'

Response

{
  "users": [
    {
      "email": "string",
      "full_name": "string"
    }
  ]
}