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