Skip to main content
PATCH
Update

Authorizations

Authorization
string
header
required

Bearer API Key. For example, "Bearer {Tenant API Key}"

Headers

Authorization
string
required

Bearer API Key. For example, "Bearer {Tenant API Key}"

Content-Type
string
required

application/json

Path Parameters

id
string
required

The ID of the access grant.

Body

application/json

Include at least one review field, or the request returns a 400. Send null to clear a field.

reviewDecision
string | null

The decision on this grant. keep accepts it, remove marks it for revocation, review_later defers it. Send null to clear it.

Available options: keep, remove, review_later

Example:

"keep"

reviewComment
string | null

Free-text note explaining the decision. Maximum 2000 characters.

Maximum string length: 2000
Example:

"Vendor export feed, contract renewed 2026-07"

grantOwner
string | null

Free-text owner for this grant, in whatever form your organization uses: a team, a person, or a service. Maximum 256 characters.

Maximum string length: 256
Example:

"platform-team"

nextReviewAt
string<date-time> | null

When this grant should next be reviewed, as an ISO 8601 date-time string.

Example:

"2027-01-31T00:00:00.000Z"

Response

The updated access grant

data
object