List Enterprise Groups

List paginated IdP groups in this enterprise

Returns a paginated list of all IdP (Identity Provider) groups in your enterprise, including their organization associations and roles.

IdP groups must be explicitly enabled for your enterprise and are only supported for some enterprise SSO connections. Contact your administrator to enable group support.

Query Parameters

skip · integer · default: "0"

Number of groups to skip for pagination. Must be >= 0.

limit · integer · default: "100"

Maximum number of groups to return. Must be between 1 and 1000.

Response

items · array · required

Array of enterprise group objects

Show Group Object

group_name · string · required

Name of the group

org_count · integer · required

Number of organizations this group belongs to

role_by_org_id · object · required

Mapping of organization IDs to roles (admin or member)

total · integer · required

Total number of groups in the enterprise

skip · integer · required

Number of groups skipped

limit · integer · required

Maximum number of groups returned

has_more · boolean · required

Whether there are more groups available

next_cursor · integer

Cursor for the next page of results

cURL

curl -X GET "https://api.devin.ai/v2/enterprise/groups?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response

{
  "items": [
    {
      "group_name": "Engineering",
      "org_count": 3,
      "role_by_org_id": {
        "org_123": "admin",
        "org_456": "member",
        "org_789": "admin"
      }
    },
    {
      "group_name": "Product",
      "org_count": 2,
      "role_by_org_id": {
        "org_123": "member",
        "org_456": "member"
      }
    }
  ],
  "total": 15,
  "skip": 0,
  "limit": 50,
  "has_more": false,
  "next_cursor": null
}