curl -s https://api.tenantsdb.com/regions

{
  "regions": [
    {
      "zone": "eu-central",
      "label": "Europe",
      "is_default": true
    },
    {
      "zone": "ap-southeast",
      "label": "Asia Pacific"
    },
    {
      "zone": "us-east",
      "label": "US East"
    },
    {
      "zone": "us-west",
      "label": "US West"
    }
  ]
}

curl -s https://api.tenantsdb.com/errors

{
  "codes": {
    "ok":                { "status": 200, "description": "Request succeeded" },
    "created":           { "status": 201, "description": "Resource was created" },
    "bad_request":       { "status": 400, "description": "Invalid input or missing fields" },
    "auth_required":     { "status": 401, "description": "Authorization header missing" },
    "unauthorized":      { "status": 401, "description": "Invalid API key" },
    "forbidden":         { "status": 403, "description": "Tier limit reached or wrong project" },
    "role_required":     { "status": 403, "description": "API key role insufficient for endpoint" },
    "scope_denied":      { "status": 403, "description": "API key scope excludes this tenant or workspace" },
    "permission_denied": { "status": 403, "description": "Database role denied the operation" },
    "not_found":         { "status": 404, "description": "Resource does not exist" },
    "conflict":          { "status": 409, "description": "Already exists or operation in progress" },
    "rate_limited":      { "status": 429, "description": "Too many requests" },
    "internal_error":    { "status": 500, "description": "Server error" }
  }
}

{
  "success": true,
  "http_status": 201,
  "code": "created",
  "api_key": "tdb_sk_a91de156...",
  "project_id": "tdb_2abf90d3"
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "session_token": "tdb_sess_a91de156...",
  "projects": [
    {
      "project_id": "tdb_2abf90d3",
      "name": "Healthcare SaaS",
      "api_key": "tdb_sk_a91de156..."
    }
  ]
}

{
  "success": true,
  "message": "Logged out"
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "count": 2,
  "projects": [
    {
      "project_id": "tdb_2abf90d3",
      "name": "Healthcare SaaS",
      "api_key": "tdb_sk_a91de156...",
      "api_key_count": 2,
      "workspaces": 3,
      "tenants": 45,
      "database_types": ["PostgreSQL", "MongoDB"],
      "created_at": "2026-01-17T20:12:06Z"
    },
    {
      "project_id": "tdb_43cd4942",
      "name": "E-commerce Platform",
      "api_key": "tdb_sk_42d5be1a...",
      "api_key_count": 1,
      "workspaces": 1,
      "tenants": 0,
      "database_types": ["PostgreSQL"],
      "created_at": "2026-01-17T20:12:24Z"
    }
  ]
}

{
  "success": true,
  "http_status": 201,
  "code": "created",
  "project_id": "tdb_43cd4942",
  "name": "E-commerce Platform",
  "api_key": "tdb_sk_42d5be1a...",
  "proxy_password": "tdb_a9b55759ef905535",
  "message": "Project created. Save your API key - it won't be shown again!"
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "project_id": "tdb_43cd4942",
  "name": "E-commerce Platform",
  "api_key": "tdb_sk_42d5be1a...",
  "proxy_password": "tdb_a9b55759ef905535"
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "project_id": "tdb_43cd4942",
  "name": "New Project Name",
  "message": "Project renamed to 'New Project Name'"
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "message": "Project 'tdb_43cd4942' deleted successfully"
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "count": 3,
  "api_keys": [
    {
      "id": 118,
      "key": "tdb_sk_1a28fba2...",
      "project_id": "tdb_701dc142",
      "project_name": "My Saas",
      "key_name": "Production",
      "tier": "scale",
      "is_active": true,
      "scope_type": "project",
      "scope_values": [],
      "role": "admin",
      "created_at": "2026-04-27T21:20:55Z",
      "last_used_at": "2026-04-28T09:14:02Z",
      "oauth_managed": false
    },
    {
      "id": 122,
      "key_name": "Reporting",
      "scope_type": "workspace",
      "scope_values": ["orders"],
      "role": "read",
      "oauth_managed": false
    },
    {
      "id": 125,
      "key_name": "OAuth: Claude",
      "scope_type": "project",
      "scope_values": [],
      "role": "mcp",
      "oauth_managed": true
    }
  ]
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "email": "[email protected]",
  "project_id": "tdb_701dc142",
  "project_name": "My Saas"
}

{
  "name": "Production",
  "role": "admin",
  "scope_type": "project",
  "scope_values": []
}

{
  "name": "Reporting",
  "role": "read",
  "scope_type": "workspace",
  "scope_values": ["orders"]
}

{
  "name": "wayne + Globex Sync",
  "role": "write",
  "scope_type": "tenant",
  "scope_values": ["wayne", "globex"]
}

{
  "success": true,
  "http_status": 201,
  "code": "created",
  "api_key": "tdb_sk_1a28fba2a972b58c0d9051c658d18d5505b8f04cd8b8526ca61fa643f34e183b",
  "proxy_password": "tdb_646145765b597e4f",
  "project_id": "tdb_701dc142",
  "name": "Production",
  "scope_type": "project",
  "scope_values": [],
  "role": "admin",
  "note": "Use api_key for HTTP API, proxy_password for database connections"
}

{
  "success": false,
  "code": "bad_request",
  "error": "Failed to generate API key: invalid scope: scope_values must be empty for scope_type=project"
}

{
  "success": false,
  "code": "bad_request",
  "error": "role \"mcp\" is reserved for OAuth integrations and cannot be created manually"
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "message": "API key successfully revoked"
}

{
  "success": false,
  "code": "oauth_managed",
  "error": "This key is managed by an OAuth connection. Revoke the connection in Connected Apps to delete it."
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "count": 2,
  "workspaces": [
    {
      "id": "main",
      "name": "main",
      "mode": "tenant",
      "database": "PostgreSQL",
      "created_at": "2026-01-15T10:30:00Z",
      "version": "1.2"
    },
    {
      "id": "controlplane",
      "name": "controlplane",
      "mode": "control",
      "database": "PostgreSQL",
      "created_at": "2026-01-15T11:00:00Z"
    }
  ]
}

{
  "success": true,
  "http_status": 201,
  "code": "created",
  "id": "myapp",
  "mode": "tenant",
  "blueprint": "myapp",
  "database": "PostgreSQL",
  "message": "Workspace 'myapp' created. Connect via proxy to build your schema.",
  "connection": {
    "host": "pg.tenantsdb.com",
    "port": 5432,
    "database": "myapp_workspace",
    "user": "tdb_2abf90d3",
    "password": "tdb_d2bf66ed7898c448"
  },
  "connection_string": "postgresql://tdb_2abf90d3:[email protected]:5432/myapp_workspace?sslmode=require"
}

{
  "success": true,
  "http_status": 201,
  "code": "created",
  "id": "myapp",
  "mode": "tenant",
  "blueprint": "myapp",
  "database": "MySQL",
  "message": "Workspace 'myapp' created. Connect via proxy to build your schema.",
  "connection": {
    "host": "mysql.tenantsdb.com",
    "port": 3306,
    "database": "myapp_workspace",
    "user": "tdb_2abf90d3",
    "password": "tdb_d2bf66ed7898c448"
  },
  "connection_string": "mysql://tdb_2abf90d3:[email protected]:3306/myapp_workspace",
  "tls": "required, see docs.tenantsdb.com/connections#mysql"
}

{
  "success": true,
  "http_status": 201,
  "code": "created",
  "id": "controlplane",
  "mode": "control",
  "database": "PostgreSQL",
  "message": "Workspace 'controlplane' created. Connect via proxy to build your schema.",
  "connection": {
    "host": "pg.tenantsdb.com",
    "port": 5432,
    "database": "controlplane_workspace",
    "user": "tdb_2abf90d3",
    "password": "tdb_d2bf66ed7898c448"
  },
  "connection_string": "postgresql://tdb_2abf90d3:[email protected]:5432/controlplane_workspace?sslmode=require"
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "id": "main",
  "name": "main",
  "mode": "tenant",
  "version": "1.2",
  "database": "PostgreSQL",
  "schema": ["CREATE TABLE users (id SERIAL PRIMARY KEY, name TEXT NOT NULL)"],
  "undeployed_changes": 2,
  "connection": {
    "host": "pg.tenantsdb.com",
    "port": 5432,
    "database": "main_workspace",
    "user": "tdb_2abf90d3",
    "password": "tdb_d2bf66ed7898c448"
  },
  "connection_string": "postgresql://tdb_2abf90d3:[email protected]:5432/main_workspace?sslmode=require",
  "settings": {
    "query_timeout_ms": 30000,
    "max_rows_per_query": 1000,
    "max_connections": 10
  }
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "message": "Workspace 'main' deleted successfully",
  "details": {
    "workspace": "main",
    "mode": "tenant",
    "versions_deleted": ["1.0", "1.1", "1.2"],
    "deletion_type": "hard",
    "metadata": "archived",
    "physical_db": "permanently destroyed"
  }
}

{
  "success": false,
  "http_status": 409,
  "code": "conflict",
  "message": "Cannot delete workspace 'main'",
  "reason": "Blueprint 'main' deployed to 2 production tenants",
  "deployed_to": ["wayne", "globex"],
  "action_required": "Delete these production tenants first, then try again"
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "result": { ... },
  "row_count": 1,
  "truncated": false,
  "max_rows_limit": 10000,
  "blueprint": "main",
  "version": "1.2",
  "undeployed_changes": 2,
  "actions": {
    "view_schema": "GET /workspaces/main",
    "add_more": "POST /workspaces/main/queries",
    "check_diff": "GET /workspaces/main/diff",
    "deploy": "POST /deployments"
  }
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "result": { ... },
  "row_count": 1,
  "truncated": false,
  "max_rows_limit": 10000,
  "actions": {
    "view_schema": "GET /workspaces/controlplane",
    "add_more": "POST /workspaces/controlplane/queries"
  }
}

{
  "source": "template",
  "template": "fintech"
}

{
  "source": "database",
  "connection": {
    "type": "postgresql",
    "host": "db.example.com",
    "port": 5432,
    "database": "mydb",
    "user": "admin",
    "password": "secret"
  }
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "message": "Schema imported to workspace 'myapp'",
  "source": "template",
  "created": ["users", "accounts", "transactions"],
  "skipped": [],
  "errors": [],
  "details": {
    "workspace": "myapp",
    "database_type": "PostgreSQL",
    "statements_executed": 3,
    "statements_skipped": 0,
    "statements_failed": 0,
    "statements_total": 3
  }
}

{
  "tables": [
    {
      "name": "users",
      "columns": [
        { "name": "id", "type": "SERIAL", "nullable": false },
        { "name": "name", "type": "TEXT", "nullable": false }
      ],
      "indexes": ["users_pkey"]
    }
  ]
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "message": "DDL 42 removed from deploy queue"
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "message": "Reverted: DROP TABLE IF EXISTS users;"
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "database_type": "PostgreSQL",
  "settings": {
    "query_timeout_ms": 30000,
    "max_rows_per_query": 10000,
    "max_connections": 100
  },
  "available_fields": ["query_timeout_ms", "max_rows_per_query", "max_connections"]
}

{
  "query_timeout_ms": 30000,
  "max_rows_per_query": 10000,
  "max_connections": 100
}

{
  "default_ttl": 3600,
  "max_keys": 50000,
  "patterns": {
    "cache:*": { "ttl": 300 },
    "session:*": { "ttl": 86400 }
  }
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "settings": { ... },
  "message": "Settings saved. Deploy to apply to tenants.",
  "pending_deploy": true,
  "database_type": "PostgreSQL"
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "blueprints": [
    {
      "id": 12,
      "name": "main",
      "version": "1.2",
      "workspace_id": "main",
      "database_type": "PostgreSQL",
      "project_id": "tdb_2abf90d3",
      "created_at": "2026-01-20T14:00:00Z",
      "deployed_to": ["wayne", "globex"],
      "ddl_statements": [
        "CREATE TABLE users (id SERIAL PRIMARY KEY, name TEXT NOT NULL)"
      ],
      "tenant_count": 12
    }
  ]
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "name": "main",
  "version": "1.2",
  "status": "deployed",
  "database": "PostgreSQL",
  "workspace": "main",
  "routing_field": "tenant_id",
  "created_at": "2026-01-20T14:00:00Z",
  "schema": [
    "CREATE TABLE users (id SERIAL PRIMARY KEY, name TEXT NOT NULL)"
  ],
  "settings": {
    "query_timeout_ms": 30000,
    "max_rows_per_query": 10000,
    "max_connections": 100
  },
  "deployment_status": {
    "deployed": true,
    "total_ddl_statements": 5,
    "deployed_to_count": 2,
    "ready_to_deploy": true
  }
}

{
  "name": "main",
  "version": "1.2",
  "database": "PostgreSQL",
  "workspace": "main",
  "created_at": 1769000400,
  "schema_error": "workspace database not reachable"
}

{
  "success": false,
  "http_status": 404,
  "code": "not_found",
  "error": "Blueprint not found: main"
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "blueprint": "main",
  "latest": "1.2",
  "total_versions": 2,
  "versions": [
    {
      "version": "1.2",
      "created_at": "2026-02-01T10:00:00Z",
      "deployed_to_count": 2,
      "ddl_count": 2
    },
    {
      "version": "1.1",
      "created_at": "2026-01-20T14:30:00Z",
      "deployed_to_count": 1,
      "ddl_count": 1
    }
  ]
}

{
  "success": false,
  "http_status": 404,
  "code": "not_found",
  "error": "No versions found for blueprint: main"
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "count": 1,
  "tenants": [
    {
      "tenant_id": "wayne",
      "status": "ready",
      "databases": [
        {
          "blueprint": "fintech",
          "database_type": "PostgreSQL",
          "isolation_level": 1
        }
      ],
      "created_at": "2026-01-20T14:00:00Z"
    }
  ]
}

{
  "success": true,
  "http_status": 201,
  "code": "created",
  "tenant_id": "wayne",
  "status": "ready",
  "databases": [
    {
      "blueprint": "fintech",
      "database_type": "PostgreSQL",
      "isolation_level": 1,
      "connection": {
        "database": "fintech__wayne",
        "connection_string": "postgresql://tdb_2abf90d3:[email protected]:5432/fintech__wayne?sslmode=require"
      }
    }
  ]
}

{
  "database": "fintech__wayne",
  "connection_string": "postgresql://tdb_2abf90d3:[email protected]:5432/fintech__wayne?sslmode=require"
}

{
  "database": "fintech__wayne",
  "connection_string": "mysql://tdb_2abf90d3:[email protected]:3306/fintech__wayne",
  "tls": "required, see docs.tenantsdb.com/connections#mysql"
}

{
  "database": "fintech__wayne",
  "connection_string": "mongodb://tdb_2abf90d3:[email protected]:27017/fintech__wayne?authMechanism=PLAIN&directConnection=true&tls=true"
}

{
  "database": "0",
  "connection_string": "rediss://wayne:[email protected]:6379/0"
}

{
  "success": true,
  "http_status": 201,
  "code": "created",
  "tenant_id": "wayne",
  "status": "provisioning",
  "databases": [
    {
      "blueprint": "fintech",
      "database_type": "PostgreSQL",
      "isolation_level": 2,
      "region": "eu-central"
    }
  ]
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "tenant_id": "wayne",
  "status": "ready",
  "databases": [
    {
      "blueprint": "fintech",
      "database_type": "PostgreSQL",
      "isolation_level": 1,
      "connection": {
        "database": "fintech__wayne",
        "connection_string": "postgresql://tdb_2abf90d3:[email protected]:5432/fintech__wayne?sslmode=require"
      }
    }
  ],
  "recovery_undo": {
    "available": true,
    "original_host": "vm-pg-01",
    "expires_at": "2026-02-01T14:00:00Z",
    "expires_in": "23h 45m",
    "command": "tdb tenants recover-undo wayne"
  },
  "created_at": "2026-01-20T14:00:00Z"
}

curl -X POST https://api.tenantsdb.com/tenants/wayne/query \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "blueprint": "fintech",
    "query": "SELECT id, name, balance FROM accounts WHERE balance > 1000"
  }'

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "tenant": "wayne",
  "result": { ... }
}

{
  "success": false,
  "http_status": 403,
  "code": "permission_denied",
  "error": "query failed: pq: permission denied for table accounts"
}

{
  "success": false,
  "http_status": 403,
  "code": "permission_denied",
  "error": "query failed: Error 1142 (42000): INSERT command denied to user 'tdb_u_xxxxxxxxxxxxxxxx_r'@'...' for table 'accounts'"
}

{
  "success": false,
  "code": "scope_denied",
  "error": "credential scoped to tenants [globex], attempted \"wayne\""
}

{
  "success": false,
  "http_status": 400,
  "code": "bad_request",
  "error": "DDL not allowed on tenant databases. Deploy schema through blueprints. See: https://docs.tenantsdb.com/getting-started.html#schema-evolution"
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "message": "Tenant 'wayne' restored successfully",
  "tenant": {
    "tenant_id": "wayne",
    "status": "ready"
  }
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "tenant_id": "wayne",
  "blueprint": "fintech",
  "status": "migrating",
  "from": 1,
  "to": 2,
  "message": "Migration in progress for 'fintech'. Check tenant status for completion."
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "tenant_id": "wayne",
  "blueprint": "fintech",
  "status": "migrating",
  "from": 2,
  "to": 2,
  "change": "region",
  "from_region": "eu-central",
  "to_region": "us-east",
  "message": "Migration in progress for 'fintech'. Check tenant status for completion."
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "message": "Backup scheduled for tenant: wayne",
  "tenant_id": "wayne",
  "type": "manual",
  "timestamp": "2026-02-15T14-30-00",
  "paths": ["postgresql/manual/2026-02-15T14-30-00/tdb_2abf90d3_tenant_wayne.sql.gz"]
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "tenant_id": "wayne",
  "count": 3,
  "backups": [
    {
      "type": "manual",
      "date": "2026-02-15T14-30-00",
      "database_type": "postgresql",
      "storage_path": "postgresql/manual/2026-02-15T14-30-00/tdb_2abf90d3_tenant_wayne.sql.gz",
      "size_bytes": 524288,
      "created_at": "2026-02-14T03:00:00Z"
    }
  ]
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "message": "Rollback scheduled for tenant: wayne",
  "tenant_id": "wayne",
  "status": "restoring",
  "paths": ["postgresql/manual/2026-02-15T14-30-00/tdb_2abf90d3_tenant_wayne.sql.gz"]
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "message": "Recovery initiated for tenant 'wayne' to 2026-02-03T17:10:59Z. Original VM preserved for 24h.",
  "tenant": {
    "tenant_id": "wayne",
    "status": "recovering",
    "target_timestamp": "2026-02-03T17:10:59Z"
  }
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "message": "Recovery undone for tenant 'wayne'. Original VM restored.",
  "tenant": {
    "tenant_id": "wayne",
    "status": "ready"
  }
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "tenant_id": "wayne",
  "count": 3,
  "deployments": [ ... ]
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "tenant_id": "wayne",
  "logs": [
    {
      "query": "SELECT * FROM users WHERE active = true",
      "source": "proxy",
      "success": true,
      "duration_ms": 4.2,
      "created_at": "2026-02-15T14:30:00Z"
    }
  ],
  "count": 50,
  "has_more": true
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "tenant_id": "wayne",
  "total_queries": 48230,
  "successful": 47891,
  "failed": 339,
  "by_source": {
    "proxy": 45000,
    "api": 3230
  },
  "avg_duration_ms": 12.4,
  "slow_queries": 18
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "count": 1,
  "jobs": [
    {
      "job_id": "dep_abc123",
      "blueprint_id": "main",
      "version": "1.2",
      "status": "completed",
      "total_tenants": 12,
      "completed_tenants": 12,
      "failed_tenants": 0,
      "created_at": "2026-02-01T10:00:00Z"
    }
  ]
}

curl -X POST https://api.tenantsdb.com/deployments \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "blueprint_id": "main",
    "version": "1.2"
  }'

{
  "success": true,
  "http_status": 201,
  "code": "created",
  "deployment": {
    "job_id": "dep_abc123",
    "blueprint_id": "main",
    "version": "1.2",
    "status": "running",
    "status_url": "/deployments/dep_abc123",
    "total_tenants": 12,
    "created_at": "2026-02-01T10:00:00Z"
  }
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "job_id": "dep_abc123",
  "blueprint_id": "main",
  "status": "running",
  "progress": 0.667,
  "progress_display": "8/12 tenants",
  "total_tenants": 12,
  "completed_tenants": 8,
  "failed_tenants": 0
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "job_id": "dep_abc123",
  "blueprint_id": "main",
  "status": "failed",
  "progress": 1.0,
  "progress_display": "12/12 tenants",
  "total_tenants": 12,
  "completed_tenants": 10,
  "failed_tenants": 2,
  "errors": [
    "tenant 'globex': constraint violation on accounts.email_unique",
    "tenant 'stark': timeout after 30s"
  ]
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "tenant": "wayne",
  "result": { ... }
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "count": 3,
  "results": [
    {
      "tenant": "wayne",
      "result": { ... }
    },
    {
      "tenant": "globex",
      "result": { ... }
    },
    {
      "tenant": "stark",
      "error": "connection timeout"
    }
  ]
}

{
  "success": false,
  "code": "role_required",
  "error": "this endpoint requires one of the following roles: admin",
  "required_roles": ["admin"],
  "current_role": "read"
}

{
  "success": false,
  "http_status": 400,
  "code": "bad_request",
  "error": "DDL not allowed on tenant databases. Deploy schema through blueprints. See: https://docs.tenantsdb.com/getting-started.html#schema-evolution"
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "tenant": "wayne",
  "result": { ... }
}

{
  "success": true,
  "http_status": 200,
  "code": "ok",
  "count": 3,
  "results": [
    {
      "tenant": "wayne",
      "result": { ... }
    },
    {
      "tenant": "globex",
      "result": { ... }
    },
    {
      "tenant": "stark",
      "error": "connection timeout"
    }
  ]
}

{
  "success": false,
  "code": "role_required",
  "error": "this endpoint requires one of the following roles: admin",
  "required_roles": ["admin"],
  "current_role": "read"
}

{
  "success": false,
  "http_status": 400,
  "code": "bad_request",
  "error": "DDL not allowed on tenant databases. Deploy schema through blueprints. See: https://docs.tenantsdb.com/getting-started.html#schema-evolution"
}