Skip to main content
Explain says what IAM decides for one principal and one action, and which roles are behind the decision. Simulate decides a list of requests as if the principal held other roles, without changing anything. Only the organization owner sends either.

Explain

POST /v2/iam/explain
Output
Explain decides from the principal’s current grants, the way a request is decided. In an organization that has not enabled IAM, every explain answers not_iam_managed with the reason iam_disabled. The action is an exact ID, and a wildcard or an unknown action answers 422. Explain does not check that the principal exists, so an unknown ID is decided like a principal without grants.

Simulate

Simulate decides a list of requests against a set of roles instead of the principal’s grants, whether or not the organization has enabled IAM. It is how an organization tests a role before granting it, or checks the requests a person sends against the roles meant to replace their current access.
POST /v2/iam/simulate
Output
One decision comes back per request, in the same order, with the same fields as an explain. The owner is not_iam_managed in a simulate too. A simulate names at most ten distinct roles and fifty requests, and an unknown action or a role of another organization answers 422.