v22

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-01140308542.4 KB
Delegated Grants

Update delegated grant

Revokes an active delegated grant

patch/zones/{zoneId}/delegated-grants/{id}

Path parameters

zoneIdstring required

Zone ID

idstring required

Delegated grant ID

Request body

status'revoked' required

Response

User authorization for a resource to be accessed on their behalf. The grant links the user, resource, and the provider that issued the grant.

idstring required

Unique identifier of the delegated grant

organization_idstring required

Organization that owns this grant

zone_idstring required

Zone this grant belongs to

user_idstring required

Reference to the user granting permission

resource_idstring required

ID of resource receiving grant

provider_idstring required

ID of the provider that issued this grant

scopesstring[] required

Granted OAuth scopes

created_atstring date-time required

Entity creation timestamp

updated_atstring date-time required

Entity update timestamp

expires_atstring date-time required

Date when grant expires

status'active' | 'expired' | 'revoked' required
refreshed_atstring date-time

Timestamp when this grant's tokens were last refreshed. Omitted if grant was never refreshed.

refresh_token_setboolean required

Indicates whether a refresh token is stored for this grant. Grants with refresh tokens can be refreshed even after access token expiration.

activeboolean

Whether the grant is currently active (deprecated - use status instead)