Sign in

v5

latestOpenAPI 3.1.02026-07-31151195455.5 KB
groups

Bulk updates a list of groups.

put/groups

Request body

Example request

{
  "groups": [
    {
      "group_id": "f454d283-ca87-4a8a-bdbb-df212eca5353",
      "description": "This group represents Active Directory group \"Payments Production Admin\". We use this AD group to facilitate staging deployments and qualifying new releases.",
      "name": "api-group",
      "admin_owner_id": "7c86c85d-0651-43e2-a748-d69d658418e8",
      "max_duration": 120,
      "require_manager_approval": false,
      "require_support_ticket": false
    },
    {
      "group_id": "99d0b81d-14be-4cf6-bd27-348b4af1d11b",
      "description": "Manages the Integrations Team on-call privileged resources. This group is automatically synced with the on-call rotation defined in PagerDuty.",
      "name": "on-call-integrations",
      "admin_owner_id": "4220bc12-ab8a-4b5d-be7b-f6bbcf9159f3",
      "max_duration": 360,
      "require_manager_approval": false,
      "require_support_ticket": true
    }
  ]
}

Response

The resulting updated group infos.

Example response

{
  "groups": [
    {
      "group_id": "f454d283-ca87-4a8a-bdbb-df212eca5353",
      "description": "This group represents Active Directory group \"Payments Production Admin\". We use this AD group to facilitate staging deployments and qualifying new releases.",
      "name": "api-group",
      "admin_owner_id": "7c86c85d-0651-43e2-a748-d69d658418e8",
      "max_duration": 120,
      "require_manager_approval": false,
      "require_support_ticket": false
    },
    {
      "group_id": "99d0b81d-14be-4cf6-bd27-348b4af1d11b",
      "description": "Manages the Integrations Team on-call privileged resources. This group is automatically synced with the on-call rotation defined in PagerDuty.",
      "name": "on-call-integrations",
      "admin_owner_id": "4220bc12-ab8a-4b5d-be7b-f6bbcf9159f3",
      "max_duration": 360,
      "require_manager_approval": false,
      "require_support_ticket": true
    }
  ]
}