Hanzo AI
OpenapiIam

Create teams

Makes a team — a named set of people that roles and permissions grant to.

POST /v1/iam/teams

Addresshttps://api.hanzo.ai/v1/iam/teams
MethodPOST
Operationpost_iam_teams
AuthAuthorization: Bearer $HANZO_API_KEY

Makes a team — a named set of people that roles and permissions grant to. Granting to a team rather than to each person keeps access correct as people come and go: add someone and they inherit what the team can do. A name already used in your organization is refused.

Request

8 fields, body application/json (required).

FieldInTypeRequiredDescription
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 create

IAM API · All Hanzo APIs · Interactive reference

How is this guide?

On this page