Hanzo
OpenapiIam

Changes who a permission grants to, what it allows, or the resources it covers.

Changes who a permission grants to, what it allows, or the resources it covers. Access changes as soon as the write lands.

POST /v1/iam/permissions/update

Addresshttps://api.hanzo.ai/v1/iam/permissions/update
MethodPOST
Operationpost_iam_permissions_update
AuthAuthorization: Bearer $HANZO_API_KEY

Changes who a permission grants to, what it allows, or the resources it covers. Access changes as soon as the write lands. What the permission is called does not change, and neither does when it was created.

Request

24 fields, body application/json (required).

FieldInTypeRequiredDescription
actionsbodystring[]
adapterbodystring
approveTimebodystring
approverbodystring
createdAtbodystring (date-time)
createdTimebodystringDescriptive metadata.
deletedbodyboolean
descriptionbodystring
displayNamebodystring
domainsbodystring[]
effectbodystring
groupsbodystring[]
idbodystring
isEnabledbodyboolean
modelbodystringAuthorization model, targets, and decision.
namebodystring
ownerbodystringIdentity — the (owner, name) natural key.
resourceTypebodystring
resourcesbodystring[]
rolesbodystring[]
statebodystring
submitterbodystringSubmission / approval workflow.
updatedAtbodystring (date-time)
usersbodystring[]Subjects the grant is evaluated for.

Response

StatusBodyMeaning
200iam.Permissionok

200 body — 24 fields.

FieldInTypeAlwaysDescription
actionsbodystring[]
adapterbodystring
approveTimebodystring
approverbodystring
createdAtbodystring (date-time)
createdTimebodystringDescriptive metadata.
deletedbodyboolean
descriptionbodystring
displayNamebodystring
domainsbodystring[]
effectbodystring
groupsbodystring[]
idbodystring
isEnabledbodyboolean
modelbodystringAuthorization model, targets, and decision.
namebodystring
ownerbodystringIdentity — the (owner, name) natural key.
resourceTypebodystring
resourcesbodystring[]
rolesbodystring[]
statebodystring
submitterbodystringSubmission / approval workflow.
updatedAtbodystring (date-time)
usersbodystring[]Subjects the grant is evaluated for.

Failure carries the platform error shape — see Errors.

Examples

hanzo iam permissions update

IAM API · All Hanzo APIs · Interactive reference

How is this guide?

On this page