Get groups
  • 17 Apr 2024
  • 1 Minute to read
  • Contributors
  • Dark
    Light
  • PDF

Get groups

  • Dark
    Light
  • PDF

Article summary

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/

NameData TypeDescription
Content-type:application/jsonfor all requests
Authorization:EAPI {token}for all requests

Request Parameters

Parameters indicated with a * are mandatory

ParameterTypeDescription
searchStringFilter 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

CodeDescription
200Successful operation
403Not allowed to use external API
500Internal server error


Was this article helpful?

What's Next