v5

latestOpenAPI 3.1.02026-07-31151195455.5 KB
access-rules

Updates the access rule config for the given group_id.

put/access-rules/{access_rule_id}

Path parameters

access_rule_idstring uuid required

The access rule ID (group ID) of the access rule.

Request body

namestring required

The name of the access rule.

descriptionstring required

A description of the group.

admin_owner_idstring uuid required

The ID of the owner of the group.

status'ACTIVE' | 'PAUSED' required

The status of the access rule.

Example request

{
  "name": "Platform Engineering",
  "description": "This access rule represents all platform engineers in the company.",
  "admin_owner_id": "7c86c85d-0651-43e2-a748-d69d658418e8",
  "status": "ACTIVE"
}

Response

The updated access rule config for the group.

access_rule_idstring uuid required

The ID (group ID) of the access rule.

namestring required

The name of the access rule.

descriptionstring required

A description of the group.

admin_owner_idstring uuid required

The ID of the owner of the group.

status'ACTIVE' | 'PAUSED' required

The status of the access rule.

Example response

{
  "access_rule_id": "7c86c85d-0651-43e2-a748-d69d658418e8",
  "name": "Platform Engineering",
  "description": "This access rule represents all platform engineers in the company.",
  "admin_owner_id": "7c86c85d-0651-43e2-a748-d69d658418e8",
  "status": "ACTIVE"
}