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.

PUT /v1/iam/permissions/{owner}/{name}

Addresshttps://api.hanzo.ai/v1/iam/permissions/{owner}/{name}
MethodPUT
Operationput_iam_permissions_by_owner_by_name
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

26 fields, body application/json (required).

FieldInTypeRequiredDescription
ownerpathstringyesIdentity — the (owner, name) natural key.
namepathstringyes
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 has no subcommand for this operation — the CLI serves only what cloud's live route table confirms. Use HTTP or an SDK.


IAM API · All Hanzo APIs · Interactive reference

How is this guide?

On this page