- Print
- DarkLight
- PDF
Article summary
Did you find this summary helpful?
Thank you for your feedback
Groups
Via this method you are able to search on specific groups. Gourps are also known as Hierarchies in the Cirrus platform You are able to find only groups which contain a 'Organization ID'.
Get /groups/
Header
Name | Data Type | Description |
---|---|---|
Content-type: | application/json | for all requests |
Authorization: | EAPI {token} | for all requests |
Request Parameters
Parameters indicated with a * are mandatory
Parameter | Type | Description |
---|---|---|
search | String | Filter of groups by Title, Path and ExternalId |
Sample Request URL
https://api.cirrusplatform.com/api/v1/integrations/groups?search=test
Sample successfull Response
Deprecated: SynchronizationKey
is no longer in use (and only kept for backward compatibility)
[
{
"ExternalId": "GroupKey5",
"Title": "GroupKey5",
"Path": "Test education \\ GroupKey5",
"ParentExternalId": null,
"SynchronizationKey": "09855da4-1697-4605-a581-e579d2ee4827",
"AllowRelationshipWithSchedules": true,
"IsArchived": false,
"IsOrganization": true
},
{
"ExternalId": "GroupKey6",
"Title": "GroupKey6",
"Path": "Test education \\ GroupKey6",
"ParentExternalId": "R014",
"SynchronizationKey": "09855da4-1697-4605-a581-e579d2ee4828",
"AllowRelationshipWithSchedules": true,
"IsArchived": false,
"IsOrganization": false
},
{
"ExternalId": "GroupKey7",
"Title": "GroupKey7",
"Path": "Test education \\ GroupKey5 \\ GroupKey7",
"ParentExternalId": "GroupKey5",
"SynchronizationKey": "09855da4-1697-4605-a581-e579d2ee4829",
"AllowRelationshipWithSchedules": true,
"IsArchived": false,
"IsOrganization": false
}
]
Unsuccesfull response
Will return a https status 200 with no content
Responses
Code | Description |
---|---|
200 | Successful operation |
403 | Not allowed to use external API |
500 | Internal server error |
Was this article helpful?