GET
/
v2
/
enterprise
/
groups
curl -X GET "https://api.devin.ai/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/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
}