Import/Export

Import and export organization configurations as JSON files.


Export

Single Organization Export - URL: /organization/<org-id> → Export button - Downloads: <org-id>-export.json

Included: - Organization ID and display name - Module selections - Variables - Override content - Metadata

Not included: - Global module content (only references) - Built constitution files - Version history


Export File Structure

{
  "organization_id": "acme-sales",
  "display_name": "Acme Sales Team",
  "version": "2.5",
  "modules": ["context", "objective", "tone"],
  "variables": {
    "organizationName": "Acme Sales",
    "escalationEmail": "sales@acme.com"
  },
  "overrides": {
    "tone": "# Tone\n\nContent here..."
  },
  "metadata": {
    "exported_at": "2026-02-08T19:30:00Z"
  }
}

Import

URL: /import

Import Modes: - Create New - Creates new organization (fails if ID exists) - Update Existing - Merges with existing organization - Replace Existing - Completely replaces existing organization

Process: 1. Upload JSON file 2. Preview what will be imported 3. Select import mode 4. Confirm import

Result: Organization created/updated, constitution rebuilt.


Bulk Operations

Export Multiple - Select organizations → Export Selected - Downloads ZIP file with individual JSON files

Import Multiple - Upload ZIP file containing multiple JSON exports - Select import mode (applies to all) - Shows progress for each organization


Last updated: February 2026