Hanzo
OpenapiIam

Grants a permission — the call that gives a person or a role the ability to do…

Grants a permission — the call that gives a person or a role the ability to do something.

POST /v1/iam/permissions

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

Grants a permission — the call that gives a person or a role the ability to do something. Adding refuses to overwrite a grant that already exists, so widening an existing one is an update, never an accident.

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 create

IAM API · All Hanzo APIs · Interactive reference

How is this guide?

On this page