{"components":{"securitySchemes":{"apiKeyHeader":{"description":"API key (hdb_...) scoped to a specific database","in":"header","name":"X-API-Key","type":"apiKey"},"bearerAuth":{"bearerFormat":"JWT","description":"JWT token from signup-baas or login","scheme":"bearer","type":"http"}}},"info":{"description":"Backend-as-a-Service API for HeliosDB Cloud. Provides database management, branching, time-travel queries, and API key management.","title":"HeliosDB Cloud BaaS API","version":"1.0.0"},"openapi":"3.1.0","paths":{"/organizations/{org_id}/databases":{"get":{"operationId":"listDatabases","parameters":[{"in":"path","name":"org_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"List of databases"}},"summary":"List databases"},"post":{"operationId":"createDatabase","parameters":[{"in":"path","name":"org_id","required":true,"schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"description":{"type":"string"},"name":{"type":"string"}},"required":["name"],"type":"object"}}},"required":true},"responses":{"201":{"description":"Database created"}},"summary":"Create database","x-tier-limits":{"enterprise":"unlimited","free":5,"pro":"unlimited","starter":20}}},"/organizations/{org_id}/databases/{db_id}/api-keys":{"get":{"operationId":"listApiKeys","parameters":[{"in":"path","name":"org_id","required":true,"schema":{"format":"uuid","type":"string"}},{"in":"path","name":"db_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"List of API keys (no raw keys)"}},"summary":"List API keys"},"post":{"operationId":"createApiKey","parameters":[{"in":"path","name":"org_id","required":true,"schema":{"format":"uuid","type":"string"}},{"in":"path","name":"db_id","required":true,"schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"expires_in_days":{"type":"integer"},"name":{"type":"string"},"scopes":{"items":{"type":"string"},"type":"array"}},"required":["name","scopes"],"type":"object"}}},"required":true},"responses":{"201":{"description":"API key created (raw key returned once)"}},"summary":"Create API key"}},"/organizations/{org_id}/databases/{db_id}/branches":{"get":{"operationId":"listBranches","parameters":[{"in":"path","name":"org_id","required":true,"schema":{"format":"uuid","type":"string"}},{"in":"path","name":"db_id","required":true,"schema":{"format":"uuid","type":"string"}}],"responses":{"200":{"description":"List of branches"}},"summary":"List branches"},"post":{"operationId":"createBranch","parameters":[{"in":"path","name":"org_id","required":true,"schema":{"format":"uuid","type":"string"}},{"in":"path","name":"db_id","required":true,"schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"as_of":{"description":"Point-in-time: 'now' (default), 'timestamp:<ISO8601>', 'transaction:<id>', or 'scn:<id>'","type":"string"},"from":{"description":"Parent branch name (defaults to current branch)","type":"string"},"name":{"description":"Branch name","pattern":"^[a-zA-Z0-9_-]+$","type":"string"}},"required":["name"],"type":"object"}}},"required":true},"responses":{"201":{"description":"Branch created"}},"summary":"Create branch","x-tier-limits":{"enterprise":"unlimited","free":5,"pro":"unlimited","starter":20}}},"/organizations/{org_id}/databases/{db_id}/branches/merge":{"post":{"operationId":"mergeBranch","parameters":[{"in":"path","name":"org_id","required":true,"schema":{"format":"uuid","type":"string"}},{"in":"path","name":"db_id","required":true,"schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"source":{"type":"string"},"strategy":{"type":"string"},"target":{"type":"string"}},"required":["source","target"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Branches merged"}},"summary":"Merge branches"}},"/organizations/{org_id}/databases/{db_id}/branches/switch":{"post":{"operationId":"switchBranch","parameters":[{"in":"path","name":"org_id","required":true,"schema":{"format":"uuid","type":"string"}},{"in":"path","name":"db_id","required":true,"schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"name":{"pattern":"^[a-zA-Z0-9_-]+$","type":"string"}},"required":["name"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Switched to branch"}},"summary":"Switch to branch"}},"/organizations/{org_id}/databases/{db_id}/execute":{"post":{"operationId":"executeSql","parameters":[{"in":"path","name":"org_id","required":true,"schema":{"format":"uuid","type":"string"}},{"in":"path","name":"db_id","required":true,"schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"params":{"items":{"type":"string"},"type":"array"},"sql":{"type":"string"}},"required":["sql"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Query result with columns and rows"}},"summary":"Execute SQL query"}},"/organizations/{org_id}/databases/{db_id}/query-at":{"post":{"description":"Execute a SQL query at a specific point in time.","operationId":"queryAt","parameters":[{"in":"path","name":"org_id","required":true,"schema":{"format":"uuid","type":"string"}},{"in":"path","name":"db_id","required":true,"schema":{"format":"uuid","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"properties":{"as_of":{"format":"date-time","type":"string"},"sql":{"type":"string"}},"required":["sql","as_of"],"type":"object"}}},"required":true},"responses":{"200":{"description":"Query result at the specified point in time"}},"summary":"Time-travel query","x-tier-limits":{"enterprise":"unlimited","free":"24h","pro":"90 days","starter":"7 days"}}},"/quick-start":{"post":{"description":"Create account, database, and API key in one call. No auth required.","operationId":"quickStart","requestBody":{"content":{"application/json":{"schema":{"properties":{"db_name":{"type":"string"},"email":{"format":"email","type":"string"},"feedback_opt_in":{"default":false,"description":"Opt in for platform feedback to unlock Trusted free tier quotas","type":"boolean"},"org_name":{"type":"string"},"password":{"minLength":8,"type":"string"},"username":{"type":"string"}},"required":["email","password","username","org_name","db_name"],"type":"object"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"properties":{"api_key":{"type":"string"},"db_id":{"type":"string"},"endpoints":{"type":"object"},"org_id":{"type":"string"},"token":{"type":"string"}},"type":"object"}}},"description":"Account and database created"}},"security":[],"summary":"Quick-start provisioning","x-tier-limits":{"rate":"3/min per IP"}}}},"security":[{"bearerAuth":[]},{"apiKeyHeader":[]}],"servers":[{"description":"Production","url":"https://cloud.heliosdb.com/api/v1"}]}