> ## Documentation Index
> Fetch the complete documentation index at: https://docs.metabind.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Organizations Overview

> Top-level containers for projects, users, and resources

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

<ParamField body="id" type="string">
  Unique identifier (UUID)
</ParamField>

<ParamField body="name" type="string">
  Organization name
</ParamField>

<ParamField body="slug" type="string">
  URL-friendly organization identifier
</ParamField>

<ParamField body="description" type="string">
  Organization description
</ParamField>

<ParamField body="status" type="string">
  Status: `active`
</ParamField>

<ParamField body="settings" type="object">
  Organization settings including timezone, locales, and feature flags
</ParamField>

<ParamField body="roles" type="object">
  Map of custom role IDs to role names
</ParamField>

<ParamField body="metadata" type="object">
  Additional organization metadata including createdBy and maxProjects
</ParamField>

<ParamField body="subscription" type="object">
  Subscription details including tier, status, and billing period
</ParamField>

<ParamField body="createdAt" type="string">
  Creation timestamp (ISO 8601 format)
</ParamField>

<ParamField body="updatedAt" type="string">
  Last update timestamp (ISO 8601 format)
</ParamField>

### 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

```json theme={null}
{
  "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