GET
/
api
/
v2
/
enterprise
/
groups
curl -X GET "https://api.devin.ai/api/v2/enterprise/groups?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "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
}

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

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 -X GET "https://api.devin.ai/api/v2/enterprise/groups?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"
{
  "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
}