Hanzo AI
OpenapiIam

Replace teams

Changes who is in a team.

PUT /v1/iam/teams/{name}

Addresshttps://api.hanzo.ai/v1/iam/teams/{name}
MethodPUT
Operationput_iam_teams_by_name
AuthAuthorization: Bearer $HANZO_API_KEY

Changes who is in a team. Access changes for everyone in it as soon as the write lands. The name and the created stamp do not change.

Request

9 fields, body application/json (required).

FieldInTypeRequiredDescription
namepathstringyesName addresses the team on update and names it on create; every other field is content and binds from the BODY, never the URL.
createdTimebodystring
descriptionbodystring
displayNamebodystring
isEnabledbodyboolean
namebodystringName addresses the team on update and names it on create; every other field is content and binds from the BODY, never the URL.
organizationbodystring
parentbodystring
usersbodystring[]

Response

StatusBodyMeaning
200iam.Teamok
202Approvalheld for approval
defaultproblem-detailsrefused

200 body — 13 fields.

FieldInTypeAlwaysDescription
createdAtbodystring (date-time)
createdTimebodystring
deletedbodyboolean
descriptionbodystring
displayNamebodystring
idbodystring
isEnabledbodyboolean
namebodystring
organizationbodystring
ownerbodystring
parentbodystring
updatedAtbodystring (date-time)
usersbodystring[]

Failure carries the platform error shape — see Errors.

Examples

hanzo iam teams set <name>

IAM API · All Hanzo APIs · Interactive reference

How is this guide?

On this page