Hanzo AI
OpenapiIam

List teams

Returns your organization's teams, newest first — each a named set of people that roles and permissions are granted to.

GET /v1/iam/teams

Addresshttps://api.hanzo.ai/v1/iam/teams
MethodGET
Operationget_iam_teams
AuthAuthorization: Bearer $HANZO_API_KEY

Returns your organization's teams, newest first — each a named set of people that roles and permissions are granted to.

You see your own organization's teams and no one else's; which organization that is comes from your credentials, not from the request.

Request

GET /v1/iam/teams takes no parameters and no body — the credential is the whole request.

Response

StatusBodyMeaning
200iam.teams.ListOutputok
202Approvalheld for approval
defaultproblem-detailsrefused

200 body — 15 fields.

FieldInTypeAlwaysDescription
teamsbodyiam.Team[]
teams[].createdAtbodystring (date-time)
teams[].createdTimebodystring
teams[].deletedbodyboolean
teams[].descriptionbodystring
teams[].displayNamebodystring
teams[].idbodystring
teams[].isEnabledbodyboolean
teams[].namebodystring
teams[].organizationbodystring
teams[].ownerbodystring
teams[].parentbodystring
teams[].updatedAtbodystring (date-time)
teams[].usersbodystring[]
totalbodyinteger (int64)

Failure carries the platform error shape — see Errors.

Examples

hanzo iam teams list

IAM API · All Hanzo APIs · Interactive reference

How is this guide?

On this page