Skip to main content
Organizations represent the top-level container for all resources within Metabind. Each organization can manage multiple projects and maintain its own set of users, roles, and settings.

​
The Organization Object

​
id
string
Unique identifier (UUID)
​
name
string
Organization name
​
slug
string
URL-friendly organization identifier
​
description
string
Organization description
​
status
string
Status: active
​
settings
object
Organization settings including timezone, locales, and feature flags
​
roles
object
Map of custom role IDs to role names
​
metadata
object
Additional organization metadata including createdBy and maxProjects
​
subscription
object
Subscription details including tier, status, and billing period
​
createdAt
string
Creation timestamp (ISO 8601 format)
​
updatedAt
string
Last update timestamp (ISO 8601 format)

​
Settings Object

FieldTypeDescription
timezonestringOrganization timezone
localesstring[]Supported locales
featuresobjectEnabled feature flags
features.assetOptimizationbooleanAsset optimization enabled
features.advancedPermissionsbooleanAdvanced permissions enabled

​
Subscription Object

FieldTypeDescription
tierIdstringCurrent subscription tier ID
statusstringSubscription status
currentPeriodStartstringCurrent billing period start (ISO 8601)
currentPeriodEndstringCurrent billing period end (ISO 8601)
limitsobjectUsage limits for the subscription tier

​
Example Object

{
  "id": "org123",
  "name": "Acme Corp",
  "slug": "acme-corp",
  "description": "Acme Corporation main organization",
  "status": "active",
  "settings": {
    "timezone": "America/New_York",
    "locales": ["en-US", "es-ES"],
    "features": {
      "assetOptimization": true,
      "advancedPermissions": true
    }
  },
  "roles": {
    "role123": "Editor",
    "role456": "Viewer"
  },
  "metadata": {
    "createdBy": "user123",
    "maxProjects": 10
  },
  "subscription": {
    "tierId": "tier_pro",
    "status": "active",
    "currentPeriodStart": "2024-03-01T00:00:00Z",
    "currentPeriodEnd": "2024-04-01T00:00:00Z"
  },
  "createdAt": "2024-01-15T10:00:00Z",
  "updatedAt": "2024-03-20T10:00:00Z"
}

​
Organization Structure

Organizations contain the following resources:
  • Projects - Workspace containers for content and assets
  • Users - Organization members with assigned roles
  • Roles - Custom permission sets for access control
  • Invitations - Pending user invitations
  • API Keys - Programmatic access credentials (per-project)
  • OAuth Clients - OAuth application registrations

​
Multi-Tenancy

Metabind enforces strict multi-tenancy at the organization level:
  • All resources are scoped to an organization
  • Users can belong to multiple organizations
  • Cross-organization data access is not permitted
  • Each organization has isolated billing and usage tracking