ObjectStackOrganization — Identity Protocol reference
Defines the standard organization/workspace model for ObjectStack. Supports B2B SaaS scenarios where users belong to multiple teams/workspaces.
Organization Schema (Multi-Tenant Architecture)
Defines the standard organization/workspace model for ObjectStack. Supports B2B SaaS scenarios where users belong to multiple teams/workspaces.
This aligns with better-auth's organization plugin capabilities.
Source: packages/spec/src/identity/organization.zod.ts
TypeScript Usage
import { InvitationSchema, InvitationStatus, MemberSchema, OrganizationSchema } from '@objectstack/spec/identity';
import type { Invitation, InvitationStatus, Member, Organization } from '@objectstack/spec/identity';
// Validate data
const result = InvitationSchema.parse(data);Invitation
Properties
| Property | Type | Required | Description |
|---|---|---|---|
| id | string | ✅ | Unique invitation identifier |
| organizationId | string | ✅ | Organization ID |
string | ✅ | Invitee email address | |
| role | string | ✅ | Role to assign upon acceptance (owner, admin, delegated_admin, member — ADR-0108 closed vocabulary) |
| status | Enum<'pending' | 'accepted' | 'rejected' | 'expired' | 'canceled'> | optional (default: "pending") | Invitation status |
| expiresAt | string | ✅ | Invitation expiry timestamp |
| inviterId | string | ✅ | User ID of the inviter |
| createdAt | string | ✅ | Invitation creation timestamp |
| updatedAt | string | optional | Last update timestamp (no such column on sys_invitation; absent on the wire) |
InvitationStatus
Allowed Values
pendingacceptedrejectedexpiredcanceled
Member
Properties
| Property | Type | Required | Description |
|---|---|---|---|
| id | string | ✅ | Unique member identifier |
| organizationId | string | ✅ | Organization ID |
| userId | string | ✅ | User ID |
| role | string | ✅ | Member role (owner, admin, delegated_admin, member — ADR-0108 closed vocabulary) |
| createdAt | string | ✅ | Member creation timestamp |
| updatedAt | string | optional | Last update timestamp (no such column on sys_member; absent on the wire) |
Organization
Properties
| Property | Type | Required | Description |
|---|---|---|---|
| id | string | ✅ | Unique organization identifier |
| name | string | ✅ | Organization display name |
| slug | string | ✅ | Unique URL-friendly slug (lowercase alphanumeric, hyphens, underscores) |
| logo | string | null | optional | Organization logo URL |
| metadata | Record<string, any> | optional | Custom metadata |
| createdAt | string | ✅ | Organization creation timestamp |
| updatedAt | string | optional | Last update timestamp (absent on the better-auth organization wire) |