Skip to content
/
OrganizationDomain
Last updated

OrganizationDomain object

🔨 In Development — This section is still being developed and may change.
The OrganizationDomain object represents email domains associated with an organization. Domains enable automatic user assignment when users register with matching email addresses.

Properties

Identity

id integer required

Unique domain identifier (auto-incrementing integer).

name string required

Domain name (e.g., aitronos.com, example.org). Should not include protocol or subdomain.

Relationships

organization_id string required

Reference to the Organization this domain belongs to.

Status

is_deleted boolean required

Soft delete flag. When true, the domain is inactive but preserved for audit purposes. Default: false.

Timestamps

created_at string required

Timestamp when the domain was added. Format: ISO 8601 datetime string.

updated_at string required

Timestamp when the domain was last updated. Format: ISO 8601 datetime string.

Domain-Based Auto-Assignment

When a user registers with an email address matching an organization's domain:

  1. System checks for matching OrganizationDomain records
  2. If match found, user is automatically added to the organization
  3. User is assigned the default "member" role
  4. User status is set to "Active"

Example Flow

User registers with john@aitronos.com:

  • System finds OrganizationDomain with name: "aitronos.com"
  • User automatically joins the associated organization
  • No invitation required

Multiple Domains

Organizations can have multiple domains:

  • company.com
  • company.org
  • subsidiary.com

Users from any of these domains will be auto-assigned to the organization.

Security Considerations

  • Domain verification should be implemented to prevent unauthorized access
  • Consider requiring email verification before auto-assignment
  • Admins should be able to disable auto-assignment per domain
  • Monitor for suspicious domain registrations

Active Domain

{
  "id": 1,
  "name": "aitronos.com",
  "organization_id": "ORG_A1B2C3D4E5F6G7H8",
  "is_deleted": false,
  "created_at": "2025-01-10T09:00:00Z",
  "updated_at": "2025-01-10T09:00:00Z"
}

Multiple Domains for One Organization

[
  {
    "id": 1,
    "name": "aitronos.com",
    "organization_id": "ORG_A1B2C3D4E5F6G7H8",
    "is_deleted": false,
    "created_at": "2025-01-10T09:00:00Z",
    "updated_at": "2025-01-10T09:00:00Z"
  },
  {
    "id": 2,
    "name": "aitronos.ai",
    "organization_id": "ORG_A1B2C3D4E5F6G7H8",
    "is_deleted": false,
    "created_at": "2025-01-10T09:05:00Z",
    "updated_at": "2025-01-10T09:05:00Z"
  },
  {
    "id": 3,
    "name": "freddy.ai",
    "organization_id": "ORG_A1B2C3D4E5F6G7H8",
    "is_deleted": false,
    "created_at": "2025-01-10T09:10:00Z",
    "updated_at": "2025-01-10T09:10:00Z"
  }
]

Deleted Domain (Soft Delete)

{
  "id": 4,
  "name": "old-company.com",
  "organization_id": "ORG_A1B2C3D4E5F6G7H8",
  "is_deleted": true,
  "created_at": "2025-01-05T08:00:00Z",
  "updated_at": "2025-01-14T16:45:00Z"
}
Previous page
Next page