Skip to main content
A managed organization is an organization that another organization, its manager, runs for one of its customers, with its own bill and its own resources. Users of the manager org work inside it as themselves, and IAM decides whether each may enter and what each may do there. A delegation names who may enter, with a role each.

Entering a Managed Organization

A request names the managed organization with the X-Managed-Account-Id header, as the Managed Accounts API describes.
Once the manager org has enabled IAM, a user or service account of the manager org needs a granted role that allows managed_account.impersonate to send such a request. The request is then decided on the action of its route, messaging_profile.create here, for the same principal and the same roles in the manager org. The managed organization’s own roles never apply to it. A refusal answers 403 like any other denied request.
POST /v2/iam/roles/{role_id}/statements
The manager org’s owner enters every managed organization with that organization owner’s full access.

A Delegation

Preview A delegation is created with each managed organization. It names the principals of the manager organization that may work there, with a role each, so a partner’s people get least privilege and every change in the managed organization’s audit log names the person who made it.
GET /v2/iam/delegations/{id}
A delegation’s grants name principals of the manager org as org:<org>/group:<group>, org:<org>/role:<role>, or org:<org> for everyone there. A new managed organization starts by granting its Owner role to whoever holds Owner in the manager org, and no other manager org user gets in until granted.

Defaults and Narrowing

Preview PUT /v2/iam/delegation_defaults sets the grants every delegation starts with, and PUT /v2/iam/delegations/{id}/grants narrows one managed organization, down to read-only for the manager org owner if that customer asks for it.

Manager Guardrails

Preview The manager org sets a guardrail on every managed organization, which the managed organization’s own admins cannot loosen. A delegated request must pass the managed organization’s guardrail and the manager org’s.