Hanzo
OpenapiIam

Answers either question about who belongs where: which organizations one person… — GET /v1/iam/get-memberships

Answers either question about who belongs where: which organizations one person can act in, or who can act in one organization.

GET /v1/iam/get-memberships

Addresshttps://api.hanzo.ai/v1/iam/get-memberships
MethodGET
Operationget_iam_get-memberships
AuthAuthorization: Bearer $HANZO_API_KEY

Answers either question about who belongs where: which organizations one person can act in, or who can act in one organization.

Both are org-scoped: a non-SuperAdmin may ask about ITS OWN org's roster, or about a user whose home org is its own, and nothing else. The bound comes from the verified credential via authz.Scope, so a request parameter can never widen it — a membership row names who may act and spend in an org, so a cross-tenant read is a customer roster leak.

Request

2 fields.

FieldInTypeRequiredDescription
userquerystringUser is "<homeOrg>/<username>" — which organizations that identity may act in.
orgquerystringOrg is an organization — who may act in it.

Response

StatusBodyMeaning
200iam.Answerok
400iam.Answerbad request

200 body — 8 fields.

FieldInTypeAlwaysDescription
codebodystring
databodyobject
data2bodyobject
data3bodyobject
msgbodystring
namebodystring
statusbodystring
subbodystring

Failure carries the platform error shape — see Errors.

Examples

hanzo iam get-memberships

IAM API · All Hanzo APIs · Interactive reference

How is this guide?

On this page