Organizations Overview

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

string

Unique identifier (UUID)

string

Organization name

string

URL-friendly organization identifier

string

Organization description

string

Status: active

object

Organization settings including timezone, locales, and feature flags

object

Map of custom role IDs to role names

object

Additional organization metadata including createdBy and maxProjects

object

Subscription details including tier, status, and billing period

string

Creation timestamp (ISO 8601 format)

string

Last update timestamp (ISO 8601 format)

Settings Object

Field	Type	Description
`timezone`	string	Organization timezone
`locales`	string[]	Supported locales
`features`	object	Enabled feature flags
`features.assetOptimization`	boolean	Asset optimization enabled
`features.advancedPermissions`	boolean	Advanced permissions enabled

Subscription Object

Field	Type	Description
`tierId`	string	Current subscription tier ID
`status`	string	Subscription status
`currentPeriodStart`	string	Current billing period start (ISO 8601)
`currentPeriodEnd`	string	Current billing period end (ISO 8601)
`limits`	object	Usage 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

Getting Started

API Basics

Organizations

Projects

Saved Searches

Folders

Components

Component Assets

Collections

Packages

Draft Packages

Content Types

Content

Assets

Asset Searching

Tags

Roles

API Keys

Organizations Overview

The Organization Object

Settings Object

Subscription Object

Example Object

Organization Structure

Multi-Tenancy

​The Organization Object

​Settings Object

​Subscription Object

​Example Object

​Organization Structure

​Multi-Tenancy

The Organization Object

Settings Object

Subscription Object

Example Object

Organization Structure

Multi-Tenancy