AEP-Compliant API Design

Design APIs following AEP (Google, Microsoft, Roblox, IBM). The payoff: Terraform providers, CLIs, UIs, and MCP servers auto-generate because they can predict the API shape from resource hierarchies.

Core principle: design resource hierarchies (nouns), not procedure collections (verbs).

Design Process

For every API, answer these four questions in order:

1. What are the resources (things)?
2. What's the parent-child hierarchy?
3. What does each resource's schema look like?
4. Which standard methods does each resource need?