Update a grant
PUT https://{tenant}.atomicwork.com/api/v1/iga/grants/{grant_id}
Update an identity grant's metadata. Use this to change the associated policy, update the grantor, or adjust grant timestamps.
Updatable fields:
status— transition the grant to a new statuspolicy_idorpolicy_key— reassign the grant to a different access policygranted_by— update the grantor identifiergranted_at— correct the grant timestamp
To revoke a grant, use the dedicated POST /iga/grants/\{grant_id\}/revoke endpoint instead — it handles deprovisioning workflows.
Authorization
X-Api-KeyrequiredAPI key authentication.
Headers
X-Workspace-IdPath Parameters
grant_idrequiredBody
statusAllowed values
GRANTEDEXPIREDEXTENDEDREVOKEDpolicy_idChange the policy associated with the grant
policy_keyChange the policy by key (alternative to policy_id)
granted_byUser ID who authorized this grant
granted_atWhen the grant was authorized
Response
200
Successful response
