Accounts
AM accounts give each customer their own billing and collaboration space. Users belong to Applications and access accounts through memberships.
Accounts can be nested to model enterprises with subsidiaries, agencies with clients, or platforms with workspaces.
Account Hierarchy
Your Platform
├── Acme Corp
│ ├── Engineering Team
│ └── Sales Team
└── Globex Inc
└── Product Team
Each level is an account. Access is managed through memberships.
Operations
| Operation | Endpoint | Description |
|---|---|---|
| Create | POST /api/applications/:application_id/register | Create account with initial owner |
| Create (empty) | POST /api/accounts/:account_id/accounts | Create subaccount without users |
| List | GET /api/accounts/:account_id/accounts | List child accounts |
| Get | GET /api/accounts/:account_id | Retrieve account details |
| Update | PATCH /api/accounts/:account_id | Modify name, avatar, settings |
| Delete | DELETE /api/accounts/:account_id | Remove account permanently |
Account Properties
{
id: "acc_...", // Unique identifier
parent_id: "app_...", // Parent resource (application or account)
name: "Acme Corp", // Display name
avatar_url: "https://..."
}
Invitations
Bring users into an account:
Related
- Applications - Service boundaries
- Account - Account resource
- Membership - User-account links