Account

Account

An Account represents an organization, team, or individual with its own billing and memberships. Accounts can be nested and always belong to a parent resource (an application or another account).

Schema

interface Account {
  id: string; // "acc..." - Unique identifier
  parent_id: string | null; // Parent resource ID (application or account)
  name: string | null; // Display name
  avatar_url: string | null; // Optional avatar image
}

Properties

Property	Type	Description
id	string	KSUID with acc prefix
parent_id	string?	Parent resource ID (application or account)
name	string?	Human-readable name
avatar_url	string?	Avatar image URL

Hierarchy

app_platform
  └─ acc_alice
       └─ acc_team

Accounts can be nested directly, and applications can be created under accounts to form alternating hierarchies.

Example

{
  "id": "acc_2kHfPZcN9xW4mE8RtY7vB",
  "parent_id": "app_root",
  "name": "Acme Corporation",
  "avatar_url": null
}

Related

• Accounts - Account management
• Applications - Service boundaries
• Membership - User-account links