Accounts

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

Endpoint	Description
POST /api/applications/:application_id/register	Create account with initial owner
POST /api/accounts/:account_id/accounts	Create subaccount without users
GET /api/accounts/:account_id/accounts	List child accounts
GET /api/accounts/:account_id	Retrieve account details
PATCH /api/accounts/:account_id	Modify name, avatar, settings
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