JavaScript: Low-level API client
sovaria.api — every Sovaria REST endpoint as a typed method, generated from the API contract, for calls the area methods don't cover.
sovaria.api exposes every REST endpoint as a typed method, generated from the API contract. Prefer the area methods (sovaria.auth, sovaria.data, …) — they add sessions, defaults and friendlier shapes — and use sovaria.api for endpoints they don't cover.
sovaria.api.auth
sovaria.api.auth.confirmVerificationEmail
Confirm an email verification token.
sovaria.api.auth.confirmVerificationEmail(args: { token: JsonValue }): Promise<JsonValue>POST /api/v1/auth/verify-email/confirm
Parameters
args{ token: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/auth/verify-email/confirm
sovaria.api.auth.disableMfa
DELETE /api/v1/auth/mfa
sovaria.api.auth.disableMfa(args: { totpCode: JsonValue }): Promise<JsonValue>Parameters
args{ totpCode: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
DELETE /api/v1/auth/mfa
sovaria.api.auth.enrollMfa
POST /api/v1/auth/mfa/enroll
sovaria.api.auth.enrollMfa(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
POST /api/v1/auth/mfa/enroll
sovaria.api.auth.getMfaStatus
GET /api/v1/auth/mfa/status
sovaria.api.auth.getMfaStatus(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /api/v1/auth/mfa/status
sovaria.api.auth.getProvidersConfig
GET /api/v1/auth/providers/config
sovaria.api.auth.getProvidersConfig(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /api/v1/auth/providers/config
sovaria.api.auth.getSessionsConfig
GET /api/v1/auth/sessions/config
sovaria.api.auth.getSessionsConfig(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /api/v1/auth/sessions/config
sovaria.api.auth.listConsoleProductUsers
GET /api/v1/auth/product-users
sovaria.api.auth.listConsoleProductUsers(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /api/v1/auth/product-users
sovaria.api.auth.listSessions
GET /api/v1/auth/sessions
sovaria.api.auth.listSessions(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /api/v1/auth/sessions
sovaria.api.auth.revokeOtherSessions
POST /api/v1/auth/sessions/revoke-others
sovaria.api.auth.revokeOtherSessions(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
POST /api/v1/auth/sessions/revoke-others
sovaria.api.auth.revokeSession
DELETE /api/v1/auth/sessions/{session_id}
sovaria.api.auth.revokeSession(args: { sessionId: string }): Promise<JsonValue>Parameters
args{ sessionId: string }required
- Returns
Promise<JsonValue>- HTTP
DELETE /api/v1/auth/sessions/{…}
sovaria.api.auth.sendVerificationEmail
Trigger a verification email for the authenticated user.
sovaria.api.auth.sendVerificationEmail(): Promise<JsonValue>POST /api/v1/auth/verify-email/send
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/auth/verify-email/send
sovaria.api.auth.updateProvidersConfig
PUT /api/v1/auth/providers/config
sovaria.api.auth.updateProvidersConfig(args: { body: JsonObject }): Promise<JsonValue>Parameters
args{ body: JsonObject }required
- Returns
Promise<JsonValue>- HTTP
PUT /api/v1/auth/providers/config
sovaria.api.auth.updateSessionsConfig
PUT /api/v1/auth/sessions/config
sovaria.api.auth.updateSessionsConfig(args: { body: JsonObject }): Promise<JsonValue>Parameters
args{ body: JsonObject }required
- Returns
Promise<JsonValue>- HTTP
PUT /api/v1/auth/sessions/config
sovaria.api.billing
sovaria.api.billing.buildInvoice
POST /api/v1/invoices/{org_id}/build
sovaria.api.billing.buildInvoice(
args?: { orgId?: string; period?: JsonValue } = {},
): Promise<JsonValue>Parameters
args{ orgId?: string; period?: JsonValue }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/invoices/{…}/build
sovaria.api.billing.cancelAccount
POST /api/v1/accounts/{account_id}/cancel
sovaria.api.billing.cancelAccount(args: { accountId: string }): Promise<JsonValue>Parameters
args{ accountId: string }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/accounts/{…}/cancel
sovaria.api.billing.checkout
POST /api/v1/billing/checkout
sovaria.api.billing.checkout(args: { body: JsonObject }): Promise<JsonValue>Parameters
args{ body: JsonObject }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/billing/checkout
sovaria.api.billing.getAccount
GET /api/v1/accounts/{account_id}
sovaria.api.billing.getAccount(args: { accountId: string }): Promise<JsonValue>Parameters
args{ accountId: string }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/accounts/{…}
sovaria.api.billing.getAccountOverage
GET /api/v1/billing/accounts/{account_id}/overage
sovaria.api.billing.getAccountOverage(args: { accountId: string }): Promise<JsonValue>Parameters
args{ accountId: string }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/billing/accounts/{…}/overage
sovaria.api.billing.getAccountOveragePrefs
GET /api/v1/billing/accounts/{account_id}/overage-prefs
sovaria.api.billing.getAccountOveragePrefs(args: { accountId: string }): Promise<JsonValue>Parameters
args{ accountId: string }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/billing/accounts/{…}/overage-prefs
sovaria.api.billing.getOrgOveragePrefs
The org's overage switches (one setting for the whole org) GET /api/v1/billing/orgs/{org_id}/overage-prefs
sovaria.api.billing.getOrgOveragePrefs(args?: { orgId?: string } = {}): Promise<JsonValue>Parameters
args{ orgId?: string }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/billing/orgs/{…}/overage-prefs
sovaria.api.billing.getCompute
GET /api/v1/compute/{org_id}
sovaria.api.billing.getCompute(
args?: { orgId?: string; period?: JsonValue } = {},
): Promise<JsonValue>Parameters
args{ orgId?: string; period?: JsonValue }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/compute/{…}
sovaria.api.billing.getFx
GET /api/v1/billing/fx
sovaria.api.billing.getFx(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /api/v1/billing/fx
sovaria.api.billing.getOpenInvoice
GET /api/v1/billing/invoices/open
sovaria.api.billing.getOpenInvoice(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /api/v1/billing/invoices/open
sovaria.api.billing.getOverage
GET /api/v1/billing/overage/{org_id}
sovaria.api.billing.getOverage(args?: { orgId?: string } = {}): Promise<JsonValue>Parameters
args{ orgId?: string }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/billing/overage/{…}
sovaria.api.billing.getPlan
Fetch a billing plan by name.
sovaria.api.billing.getPlan(args: { name: string }): Promise<JsonValue>GET /api/v1/plans/{name}
Parameters
args{ name: string }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/plans/{…}
sovaria.api.billing.getProvider
GET /api/v1/billing/provider
sovaria.api.billing.getProvider(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /api/v1/billing/provider
sovaria.api.billing.getSubscription
Fetch the active subscription for an organisation.
sovaria.api.billing.getSubscription(args?: { orgId?: string } = {}): Promise<JsonValue>GET /api/v1/subscriptions/{org_id}
Parameters
args{ orgId?: string }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/subscriptions/{…}
sovaria.api.billing.getUsage
Fetch usage counters for an organisation.
sovaria.api.billing.getUsage(
args?: { orgId?: string; period?: JsonValue } = {},
): Promise<JsonValue>GET /api/v1/usage/{org_id}
Parameters
args{ orgId?: string; period?: JsonValue }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/usage/{…}
sovaria.api.billing.getUsageHistory
Fetch historical usage for an organisation.
sovaria.api.billing.getUsageHistory(
args?: { orgId?: string; months?: JsonValue } = {},
): Promise<JsonValue>GET /api/v1/usage/{org_id}/history
Parameters
args{ orgId?: string; months?: JsonValue }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/usage/{…}/history
sovaria.api.billing.listInvoices
GET /api/v1/invoices/{org_id}
sovaria.api.billing.listInvoices(args?: { orgId?: string } = {}): Promise<JsonValue>Parameters
args{ orgId?: string }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/invoices/{…}
sovaria.api.billing.listPlans
List public billing plans.
sovaria.api.billing.listPlans(): Promise<JsonValue>GET /api/v1/plans
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/plans
sovaria.api.billing.listSubscriptions
List subscriptions visible to the authenticated caller.
sovaria.api.billing.listSubscriptions(): Promise<JsonValue>GET /api/v1/subscriptions
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/subscriptions
sovaria.api.billing.payInvoice
POST /api/v1/billing/invoices/{org_id}/{period}/pay
sovaria.api.billing.payInvoice(args: { orgId?: string; period: string }): Promise<JsonValue>Parameters
args{ orgId?: string; period: string }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/billing/invoices/{…}/{…}/pay
sovaria.api.billing.razorpayCreateOrder
POST /api/v1/billing/razorpay/create-order
sovaria.api.billing.razorpayCreateOrder(args: { body: JsonObject }): Promise<JsonValue>Parameters
args{ body: JsonObject }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/billing/razorpay/create-order
sovaria.api.billing.razorpayVerifyPayment
POST /api/v1/billing/razorpay/verify-payment
sovaria.api.billing.razorpayVerifyPayment(args: { body: JsonObject }): Promise<JsonValue>Parameters
args{ body: JsonObject }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/billing/razorpay/verify-payment
sovaria.api.billing.resumeAccount
POST /api/v1/accounts/{account_id}/resume
sovaria.api.billing.resumeAccount(args: { accountId: string }): Promise<JsonValue>Parameters
args{ accountId: string }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/accounts/{…}/resume
sovaria.api.billing.setAccountOveragePrefs
PUT /api/v1/billing/accounts/{account_id}/overage-prefs
sovaria.api.billing.setAccountOveragePrefs(
args: { accountId: string; services: JsonValue },
): Promise<JsonValue>Parameters
args{ accountId: string; services: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
PUT /api/v1/billing/accounts/{…}/overage-prefs
sovaria.api.billing.setOrgOveragePrefs
Change the org's overage switches (org owners and admins) PUT /api/v1/billing/orgs/{org_id}/overage-prefs
sovaria.api.billing.setOrgOveragePrefs(
args: { orgId?: string; services: JsonValue },
): Promise<JsonValue>Parameters
args{ orgId?: string; services: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
PUT /api/v1/billing/orgs/{…}/overage-prefs
sovaria.api.data
sovaria.api.data.addColumn
Add a column to an existing table.
sovaria.api.data.addColumn(
args: { tableName: JsonValue; columnName: JsonValue; dataType: JsonValue; isNullable?: JsonValue; isUnique?: JsonValue; defaultValue?: JsonValue },
): Promise<JsonValue>POST /api/v1/data/rel/column/add
Parameters
args{ tableName: JsonValue; columnName: JsonValue; dataType: JsonValue; isNullable?: JsonValue; isUnique?: JsonValue; defaultValue?: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/data/rel/column/add
sovaria.api.data.addForeignKey
Add a foreign-key relation.
sovaria.api.data.addForeignKey(
args: { tableName: JsonValue; columnName: JsonValue; referencedTable: JsonValue; referencedColumn: JsonValue },
): Promise<JsonValue>POST /api/v1/data/rel/foreign-key/add
Parameters
args{ tableName: JsonValue; columnName: JsonValue; referencedTable: JsonValue; referencedColumn: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/data/rel/foreign-key/add
sovaria.api.data.beginTransaction
Start a table transaction and receive tx/snapshot IDs.
sovaria.api.data.beginTransaction(): Promise<JsonValue>POST /api/v1/data/rel/transaction/begin
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/data/rel/transaction/begin
sovaria.api.data.commitTransaction
Commit a previously opened table transaction.
sovaria.api.data.commitTransaction(args: { txid: JsonValue }): Promise<JsonValue>POST /api/v1/data/rel/transaction/commit
Parameters
args{ txid: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/data/rel/transaction/commit
sovaria.api.data.dropColumn
Drop a column from a table.
sovaria.api.data.dropColumn(
args: { tableName: JsonValue; columnName: JsonValue },
): Promise<JsonValue>POST /api/v1/data/rel/column/drop
Parameters
args{ tableName: JsonValue; columnName: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/data/rel/column/drop
sovaria.api.data.dropForeignKey
Drop a foreign-key relation.
sovaria.api.data.dropForeignKey(
args: { tableName: JsonValue; columnName: JsonValue; referencedTable: JsonValue; referencedColumn: JsonValue },
): Promise<JsonValue>POST /api/v1/data/rel/foreign-key/drop
Parameters
args{ tableName: JsonValue; columnName: JsonValue; referencedTable: JsonValue; referencedColumn: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/data/rel/foreign-key/drop
sovaria.api.data.dropTable
Drop a relational table.
sovaria.api.data.dropTable(args: { tableName: JsonValue }): Promise<JsonValue>POST /api/v1/data/rel/drop
Parameters
args{ tableName: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/data/rel/drop
sovaria.api.data.rollbackTransaction
POST /api/v1/data/rel/transaction/rollback
sovaria.api.data.rollbackTransaction(args: { txid: JsonValue }): Promise<JsonValue>Parameters
args{ txid: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/data/rel/transaction/rollback
sovaria.api.e2ee
sovaria.api.e2ee.bootstrapKey
Create (or fetch) the active e2ee channel key.
sovaria.api.e2ee.bootstrapKey(
args: { channel: JsonValue; ttlSeconds?: JsonValue; forceNew?: JsonValue },
): Promise<JsonValue>POST /api/v1/rt/e2ee/keys/bootstrap
Parameters
args{ channel: JsonValue; ttlSeconds?: JsonValue; forceNew?: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/rt/e2ee/keys/bootstrap
sovaria.api.e2ee.getActiveKey
Get the active e2ee key for a channel, wrapped for `client_public_key
sovaria.api.e2ee.getActiveKey(
args: { channel: string; clientPublicKey?: JsonValue },
): Promise<JsonValue>GET /api/v1/rt/e2ee/keys/active/{channel}
Parameters
args{ channel: string; clientPublicKey?: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/rt/e2ee/keys/active/{…}
sovaria.api.e2ee.getKey
Get key material by channel/key_id, wrapped for `client_public_key
sovaria.api.e2ee.getKey(
args: { channel: string; keyId: string; clientPublicKey?: JsonValue },
): Promise<JsonValue>GET /api/v1/rt/e2ee/keys/{channel}/{key_id}
Parameters
args{ channel: string; keyId: string; clientPublicKey?: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/rt/e2ee/keys/{…}/{…}
sovaria.api.e2ee.listKeys
List key metadata for a channel.
sovaria.api.e2ee.listKeys(args: { channel: string }): Promise<JsonValue>GET /api/v1/rt/e2ee/keys/{channel}
Parameters
args{ channel: string }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/rt/e2ee/keys/{…}
sovaria.api.e2ee.revokeKey
Revoke an active or historical channel key.
sovaria.api.e2ee.revokeKey(
args: { channel: JsonValue; keyId?: JsonValue; reason?: JsonValue },
): Promise<JsonValue>POST /api/v1/rt/e2ee/keys/revoke
Parameters
args{ channel: JsonValue; keyId?: JsonValue; reason?: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/rt/e2ee/keys/revoke
sovaria.api.e2ee.rotateKey
Rotate e2ee key material for a channel.
sovaria.api.e2ee.rotateKey(
args: { channel: JsonValue; ttlSeconds?: JsonValue },
): Promise<JsonValue>POST /api/v1/rt/e2ee/keys/rotate
Parameters
args{ channel: JsonValue; ttlSeconds?: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/rt/e2ee/keys/rotate
sovaria.api.functions
sovaria.api.functions.delete
DELETE /api/v1/fn/functions/{function_name}
sovaria.api.functions.delete(args: { functionName: string }): Promise<JsonValue>Parameters
args{ functionName: string }required
- Returns
Promise<JsonValue>- HTTP
DELETE /api/v1/fn/functions/{…}
sovaria.api.functions.get
GET /api/v1/fn/functions/{function_name}
sovaria.api.functions.get(
args: { functionName: string; projectId?: JsonValue },
): Promise<JsonValue>Parameters
args{ functionName: string; projectId?: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/fn/functions/{…}
sovaria.api.functions.getBindings
GET /api/v1/fn/functions/{function_name}/bindings
sovaria.api.functions.getBindings(args: { functionName: string }): Promise<JsonValue>Parameters
args{ functionName: string }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/fn/functions/{…}/bindings
sovaria.api.functions.getPolicy
GET /api/v1/fn/functions/{function_name}/policy
sovaria.api.functions.getPolicy(args: { functionName: string }): Promise<JsonValue>Parameters
args{ functionName: string }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/fn/functions/{…}/policy
sovaria.api.functions.getSource
GET /api/v1/fn/functions/{function_name}/source
sovaria.api.functions.getSource(
args: { functionName: string; projectId?: JsonValue },
): Promise<JsonValue>Parameters
args{ functionName: string; projectId?: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/fn/functions/{…}/source
sovaria.api.functions.githubCommit
POST /api/v1/fn/github/commit
sovaria.api.functions.githubCommit(args: { body: JsonObject }): Promise<JsonValue>Parameters
args{ body: JsonObject }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/fn/github/commit
sovaria.api.functions.githubImport
POST /api/v1/fn/github/import
sovaria.api.functions.githubImport(args: { body: JsonObject }): Promise<JsonValue>Parameters
args{ body: JsonObject }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/fn/github/import
sovaria.api.functions.invocationStatus
Get status for an async Forge invocation id.
sovaria.api.functions.invocationStatus(
args: { invocationId: string; projectId?: JsonValue },
): Promise<JsonValue>GET /api/v1/fn/invocations/{invocation_id}
Parameters
args{ invocationId: string; projectId?: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/fn/invocations/{…}
sovaria.api.functions.list
List Forge functions with active version and queue summary.
sovaria.api.functions.list(
args?: { projectId?: JsonValue; limit?: JsonValue; offset?: JsonValue } = {},
): Promise<JsonValue>GET /api/v1/fn/functions
Parameters
args{ projectId?: JsonValue; limit?: JsonValue; offset?: JsonValue }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/fn/functions
sovaria.api.functions.simulationDiff
Diff two simulation invocation outputs.
sovaria.api.functions.simulationDiff(
args: { functionName: string; projectId?: JsonValue; leftInvocationId?: JsonValue; rightInvocationId?: JsonValue },
): Promise<JsonValue>GET /api/v1/fn/{function_name}/history/simulation-diff
Parameters
args{ functionName: string; projectId?: JsonValue; leftInvocationId?: JsonValue; rightInvocationId?: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/fn/{…}/history/simulation-diff
sovaria.api.functions.status
Get forge deployment status by deploy id.
sovaria.api.functions.status(
args: { deployId: string; projectId?: JsonValue },
): Promise<JsonValue>GET /api/v1/fn/{deploy_id}/status
Parameters
args{ deployId: string; projectId?: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/fn/{…}/status
sovaria.api.functions.update
PATCH /api/v1/fn/functions/{function_name}
sovaria.api.functions.update(
args: { functionName: string; body: JsonObject; projectId?: JsonValue },
): Promise<JsonValue>Parameters
args{ functionName: string; body: JsonObject; projectId?: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
PATCH /api/v1/fn/functions/{…}
sovaria.api.functions.updateBindings
PUT /api/v1/fn/functions/{function_name}/bindings
sovaria.api.functions.updateBindings(
args: { functionName: string; bindings: JsonValue },
): Promise<JsonValue>Parameters
args{ functionName: string; bindings: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
PUT /api/v1/fn/functions/{…}/bindings
sovaria.api.functions.updatePolicy
PUT /api/v1/fn/functions/{function_name}/policy
sovaria.api.functions.updatePolicy(
args: { functionName: string; policy: JsonObject },
): Promise<JsonValue>Parameters
args{ functionName: string; policy: JsonObject }required
- Returns
Promise<JsonValue>- HTTP
PUT /api/v1/fn/functions/{…}/policy
sovaria.api.functions.versions
List deployment versions for a Forge function.
sovaria.api.functions.versions(
args: { functionName: string; projectId?: JsonValue; limit?: JsonValue; offset?: JsonValue },
): Promise<JsonValue>GET /api/v1/fn/{function_name}/versions
Parameters
args{ functionName: string; projectId?: JsonValue; limit?: JsonValue; offset?: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/fn/{…}/versions
sovaria.api.governance
sovaria.api.governance.adminDatabases
GET /api/v1/governance/admin/databases
sovaria.api.governance.adminDatabases(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /api/v1/governance/admin/databases
sovaria.api.governance.getTenant
GET /api/v1/governance/tenants/{org_id}
sovaria.api.governance.getTenant(args?: { orgId?: string } = {}): Promise<JsonValue>Parameters
args{ orgId?: string }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/governance/tenants/{…}
sovaria.api.governance.getTenantDatabaseConnection
GET /api/v1/governance/tenants/{org_id}/databases/{project_id}/connection
sovaria.api.governance.getTenantDatabaseConnection(
args?: { orgId?: string; projectId?: string } = {},
): Promise<JsonValue>Parameters
args{ orgId?: string; projectId?: string }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/governance/tenants/{…}/databases/{…}/connection
sovaria.api.governance.listHosts
GET /api/v1/governance/hosts
sovaria.api.governance.listHosts(args?: { regionId?: JsonValue } = {}): Promise<JsonValue>Parameters
args{ regionId?: JsonValue }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/governance/hosts
sovaria.api.governance.listRegions
GET /api/v1/governance/regions
sovaria.api.governance.listRegions(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /api/v1/governance/regions
sovaria.api.governance.listTenantDatabaseBackups
GET /api/v1/governance/tenants/{org_id}/databases/{project_id}/backups
sovaria.api.governance.listTenantDatabaseBackups(
args?: { orgId?: string; projectId?: string; limit?: JsonValue } = {},
): Promise<JsonValue>Parameters
args{ orgId?: string; projectId?: string; limit?: JsonValue }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/governance/tenants/{…}/databases/{…}/backups
sovaria.api.governance.listTenantDatabases
GET /api/v1/governance/tenants/{org_id}/databases
sovaria.api.governance.listTenantDatabases(args?: { orgId?: string } = {}): Promise<JsonValue>Parameters
args{ orgId?: string }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/governance/tenants/{…}/databases
sovaria.api.governance.listTenants
GET /api/v1/governance/tenants
sovaria.api.governance.listTenants(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /api/v1/governance/tenants
sovaria.api.governance.metricsOverview
GET /api/v1/governance/metrics/overview
sovaria.api.governance.metricsOverview(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /api/v1/governance/metrics/overview
sovaria.api.governance.patchHost
PATCH /api/v1/governance/hosts/{host_id}
sovaria.api.governance.patchHost(args: { hostId: string; body: JsonObject }): Promise<JsonValue>Parameters
args{ hostId: string; body: JsonObject }required
- Returns
Promise<JsonValue>- HTTP
PATCH /api/v1/governance/hosts/{…}
sovaria.api.governance.patchRegion
PATCH /api/v1/governance/regions/{region_id}
sovaria.api.governance.patchRegion(
args: { regionId: string; body: JsonObject },
): Promise<JsonValue>Parameters
args{ regionId: string; body: JsonObject }required
- Returns
Promise<JsonValue>- HTTP
PATCH /api/v1/governance/regions/{…}
sovaria.api.governance.pauseTenantDatabase
POST /api/v1/governance/tenants/{org_id}/databases/{project_id}/pause
sovaria.api.governance.pauseTenantDatabase(
args?: { orgId?: string; projectId?: string } = {},
): Promise<JsonValue>Parameters
args{ orgId?: string; projectId?: string }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/governance/tenants/{…}/databases/{…}/pause
sovaria.api.governance.resizeTenantDatabase
POST /api/v1/governance/tenants/{org_id}/databases/{project_id}/resize
sovaria.api.governance.resizeTenantDatabase(
args: { orgId?: string; projectId?: string; computeSize: JsonValue },
): Promise<JsonValue>Parameters
args{ orgId?: string; projectId?: string; computeSize: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/governance/tenants/{…}/databases/{…}/resize
sovaria.api.governance.resumeTenantDatabase
POST /api/v1/governance/tenants/{org_id}/databases/{project_id}/resume
sovaria.api.governance.resumeTenantDatabase(
args?: { orgId?: string; projectId?: string } = {},
): Promise<JsonValue>Parameters
args{ orgId?: string; projectId?: string }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/governance/tenants/{…}/databases/{…}/resume
sovaria.api.governance.revealTenantDatabaseConnection
POST /api/v1/governance/tenants/{org_id}/databases/{project_id}/connection/reveal
sovaria.api.governance.revealTenantDatabaseConnection(
args?: { orgId?: string; projectId?: string } = {},
): Promise<JsonValue>Parameters
args{ orgId?: string; projectId?: string }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/governance/tenants/{…}/databases/{…}/connection/reveal
sovaria.api.governance.setTenantStatus
POST /api/v1/governance/tenants/{org_id}/status
sovaria.api.governance.setTenantStatus(
args: { orgId?: string; status: JsonValue },
): Promise<JsonValue>Parameters
args{ orgId?: string; status: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/governance/tenants/{…}/status
sovaria.api.governance.triggerTenantDatabaseBackup
POST /api/v1/governance/tenants/{org_id}/databases/{project_id}/backups
sovaria.api.governance.triggerTenantDatabaseBackup(
args?: { orgId?: string; projectId?: string } = {},
): Promise<JsonValue>Parameters
args{ orgId?: string; projectId?: string }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/governance/tenants/{…}/databases/{…}/backups
sovaria.api.history
sovaria.api.history.commit
Create a Chrono commit.
sovaria.api.history.commit(
args?: { timeline?: JsonValue; message?: JsonValue; author?: JsonValue; eventType?: JsonValue } = {},
): Promise<JsonValue>POST /api/v1/chrono/commit
Parameters
args{ timeline?: JsonValue; message?: JsonValue; author?: JsonValue; eventType?: JsonValue }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/chrono/commit
sovaria.api.history.converge
Converge source timeline into target timeline.
sovaria.api.history.converge(
args?: { target?: JsonValue; source?: JsonValue; author?: JsonValue; message?: JsonValue } = {},
): Promise<JsonValue>POST /api/v1/chrono/timelines/converge
Parameters
args{ target?: JsonValue; source?: JsonValue; author?: JsonValue; message?: JsonValue }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/chrono/timelines/converge
sovaria.api.history.createSnapshot
Create a system snapshot.
sovaria.api.history.createSnapshot(args: { message: JsonValue }): Promise<JsonValue>POST /api/v1/chrono/snapshots/create
Parameters
args{ message: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/chrono/snapshots/create
sovaria.api.history.deleteTimeline
Delete a timeline.
sovaria.api.history.deleteTimeline(args: { name: string }): Promise<JsonValue>DELETE /api/v1/chrono/timelines/{name}
Parameters
args{ name: string }required
- Returns
Promise<JsonValue>- HTTP
DELETE /api/v1/chrono/timelines/{…}
sovaria.api.history.jumpTimeline
Force-jump a timeline head.
sovaria.api.history.jumpTimeline(
args: { name: string; targetHex: JsonValue },
): Promise<JsonValue>POST /api/v1/chrono/timelines/{name}/jump
Parameters
args{ name: string; targetHex: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/chrono/timelines/{…}/jump
sovaria.api.history.listSnapshots
List known snapshots.
sovaria.api.history.listSnapshots(): Promise<JsonValue>GET /api/v1/chrono/snapshots
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/chrono/snapshots
sovaria.api.history.listTimelines
List available timelines.
sovaria.api.history.listTimelines(): Promise<JsonValue>GET /api/v1/chrono/timelines
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/chrono/timelines
sovaria.api.history.restoreSnapshot
Restore a snapshot by id.
sovaria.api.history.restoreSnapshot(args: { snapshotId: string }): Promise<JsonValue>POST /api/v1/chrono/snapshots/{snapshot_id}/restore
Parameters
args{ snapshotId: string }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/chrono/snapshots/{…}/restore
sovaria.api.history.spawnTimeline
Spawn a new timeline from a source chronon.
sovaria.api.history.spawnTimeline(
args?: { name?: JsonValue; sourceHexId?: JsonValue } = {},
): Promise<JsonValue>POST /api/v1/chrono/timelines/spawn
Parameters
args{ name?: JsonValue; sourceHexId?: JsonValue }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/chrono/timelines/spawn
sovaria.api.history.timelineHistory
Fetch timeline history chronons.
sovaria.api.history.timelineHistory(
args: { name: string; limit?: JsonValue; offset?: JsonValue },
): Promise<JsonValue>GET /api/v1/chrono/timelines/{name}/history
Parameters
args{ name: string; limit?: JsonValue; offset?: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/chrono/timelines/{…}/history
sovaria.api.history.topology
Return timeline graph topology.
sovaria.api.history.topology(
args?: { timeline?: JsonValue; limit?: JsonValue } = {},
): Promise<JsonValue>GET /api/v1/chrono/timelines/topology
Parameters
args{ timeline?: JsonValue; limit?: JsonValue }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/chrono/timelines/topology
sovaria.api.history.variance
Calculate variance between two chronons.
sovaria.api.history.variance(
args?: { oldChrononHex?: JsonValue; newChrononHex?: JsonValue; domainFilter?: JsonValue } = {},
): Promise<JsonValue>POST /api/v1/chrono/variance
Parameters
args{ oldChrononHex?: JsonValue; newChrononHex?: JsonValue; domainFilter?: JsonValue }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/chrono/variance
sovaria.api.org
sovaria.api.org.acceptOrgInvite
POST /api/v1/org/invites/accept
sovaria.api.org.acceptOrgInvite(args: { token: JsonValue }): Promise<JsonValue>Parameters
args{ token: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/org/invites/accept
sovaria.api.org.addMember
Add a user as a member of an org/project node.
sovaria.api.org.addMember(
args: { orgId?: string; userId: JsonValue; role?: JsonValue },
): Promise<JsonValue>POST /api/v1/org/{org_id}/member
Parameters
args{ orgId?: string; userId: JsonValue; role?: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/org/{…}/member
sovaria.api.org.createEdge
Connect two DAPG nodes with a typed relationship.
sovaria.api.org.createEdge(
args: { sourceNodeId: JsonValue; targetNodeId: JsonValue; relationType: JsonValue; role?: JsonValue },
): Promise<JsonValue>POST /api/v1/edge
Parameters
args{ sourceNodeId: JsonValue; targetNodeId: JsonValue; relationType: JsonValue; role?: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/edge
sovaria.api.org.createOrgInvite
POST /api/v1/org/{org_id}/invites
sovaria.api.org.createOrgInvite(
args: { orgId?: string; email: JsonValue; role: JsonValue },
): Promise<JsonValue>Parameters
args{ orgId?: string; email: JsonValue; role: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/org/{…}/invites
sovaria.api.org.deleteOrg
DELETE /api/v1/org/{org_id}
sovaria.api.org.deleteOrg(args?: { orgId?: string } = {}): Promise<JsonValue>Parameters
args{ orgId?: string }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
DELETE /api/v1/org/{…}
sovaria.api.org.ensureDefaultApiKeys
POST /api/v1/apikeys/ensure-defaults
sovaria.api.org.ensureDefaultApiKeys(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
POST /api/v1/apikeys/ensure-defaults
sovaria.api.org.getChildren
List child nodes attached by a relation (e.g.
sovaria.api.org.getChildren(
args: { parentId: string; relation?: JsonValue },
): Promise<JsonValue>OWNS, HAS_ENV). GET /api/v1/org/{parent_id}/children
Parameters
args{ parentId: string; relation?: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/org/{…}/children
sovaria.api.org.getContext
Resolve a user's roles on a resource by walking the DAPG.
sovaria.api.org.getContext(args: { userId: string; resourceId: string }): Promise<JsonValue>GET /api/v1/context/{user_id}/{resource_id}
Parameters
args{ userId: string; resourceId: string }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/context/{…}/{…}
sovaria.api.org.getNode
Fetch a single graph node by ID.
sovaria.api.org.getNode(args: { nodeId: string }): Promise<JsonValue>GET /api/v1/org/{node_id}
Parameters
args{ nodeId: string }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/org/{…}
sovaria.api.org.getProjectRef
GET /api/v1/org/{project_id}/ref
sovaria.api.org.getProjectRef(args?: { projectId?: string } = {}): Promise<JsonValue>Parameters
args{ projectId?: string }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/org/{…}/ref
sovaria.api.org.getProjectSettings
GET /api/v1/project-settings
sovaria.api.org.getProjectSettings(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /api/v1/project-settings
sovaria.api.org.getRoleCatalog
GET /api/v1/roles/catalog
sovaria.api.org.getRoleCatalog(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /api/v1/roles/catalog
sovaria.api.org.getRoleMatrix
GET /api/v1/roles/matrix
sovaria.api.org.getRoleMatrix(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /api/v1/roles/matrix
sovaria.api.org.listApiKeys
GET /api/v1/apikeys
sovaria.api.org.listApiKeys(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /api/v1/apikeys
sovaria.api.org.listNodes
List graph nodes; when provided, `node_type filters by type
sovaria.api.org.listNodes(args?: { nodeType?: JsonValue } = {}): Promise<JsonValue>GET /api/v1/org
Parameters
args{ nodeType?: JsonValue }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/org
sovaria.api.org.listOrgMembers
GET /api/v1/org/{org_id}/members
sovaria.api.org.listOrgMembers(args?: { orgId?: string } = {}): Promise<JsonValue>Parameters
args{ orgId?: string }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/org/{…}/members
sovaria.api.org.removeOrgMember
DELETE /api/v1/org/{org_id}/member/{user_id}
sovaria.api.org.removeOrgMember(args: { orgId?: string; userId: string }): Promise<JsonValue>Parameters
args{ orgId?: string; userId: string }required
- Returns
Promise<JsonValue>- HTTP
DELETE /api/v1/org/{…}/member/{…}
sovaria.api.org.revokeApiKey
DELETE /api/v1/apikeys/{key_id}
sovaria.api.org.revokeApiKey(args: { keyId: string }): Promise<JsonValue>Parameters
args{ keyId: string }required
- Returns
Promise<JsonValue>- HTTP
DELETE /api/v1/apikeys/{…}
sovaria.api.org.setOrgPlan
PUT /api/v1/org/{org_id}/plan
sovaria.api.org.setOrgPlan(args: { orgId?: string; plan: JsonValue }): Promise<JsonValue>Parameters
args{ orgId?: string; plan: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
PUT /api/v1/org/{…}/plan
sovaria.api.org.updateMemberRole
PUT /api/v1/org/{org_id}/member/{user_id}
sovaria.api.org.updateMemberRole(
args: { orgId?: string; userId: string; role: JsonValue },
): Promise<JsonValue>Parameters
args{ orgId?: string; userId: string; role: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
PUT /api/v1/org/{…}/member/{…}
sovaria.api.org.updateOrg
PUT /api/v1/org/{org_id}
sovaria.api.org.updateOrg(args: { orgId?: string; body: JsonObject }): Promise<JsonValue>Parameters
args{ orgId?: string; body: JsonObject }required
- Returns
Promise<JsonValue>- HTTP
PUT /api/v1/org/{…}
sovaria.api.org.updateProjectSettings
PUT /api/v1/project-settings
sovaria.api.org.updateProjectSettings(args: { settings: JsonValue }): Promise<JsonValue>Parameters
args{ settings: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
PUT /api/v1/project-settings
sovaria.api.org.updateRoleMatrix
PUT /api/v1/roles/matrix
sovaria.api.org.updateRoleMatrix(args: { matrix: JsonValue }): Promise<JsonValue>Parameters
args{ matrix: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
PUT /api/v1/roles/matrix
sovaria.api.platform
sovaria.api.platform.createEventHook
POST /api/v1/auth/event-hooks
sovaria.api.platform.createEventHook(args: { body: JsonObject }): Promise<JsonValue>Parameters
args{ body: JsonObject }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/auth/event-hooks
sovaria.api.platform.deleteEventHook
DELETE /api/v1/auth/event-hooks/{hook_id}
sovaria.api.platform.deleteEventHook(args: { hookId: string }): Promise<JsonValue>Parameters
args{ hookId: string }required
- Returns
Promise<JsonValue>- HTTP
DELETE /api/v1/auth/event-hooks/{…}
sovaria.api.platform.disconnectGithub
DELETE /api/v1/auth/github/connection-state
sovaria.api.platform.disconnectGithub(args?: { projectId?: JsonValue } = {}): Promise<JsonValue>Parameters
args{ projectId?: JsonValue }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
DELETE /api/v1/auth/github/connection-state
sovaria.api.platform.gatewayHealth
GET /healthz
sovaria.api.platform.gatewayHealth(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /healthz
sovaria.api.platform.getEnginesHealth
Return aggregate gateway health for downstream engines.
sovaria.api.platform.getEnginesHealth(): Promise<JsonValue>GET /api/v1/system/engines/health
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/system/engines/health
sovaria.api.platform.getErrorTrace
GET /api/v1/error-traces/{trace_id}
sovaria.api.platform.getErrorTrace(args: { traceId: string }): Promise<JsonValue>Parameters
args{ traceId: string }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/error-traces/{…}
sovaria.api.platform.getGithubConnectionState
GET /api/v1/auth/github/connection-state
sovaria.api.platform.getGithubConnectionState(
args?: { projectId?: JsonValue } = {},
): Promise<JsonValue>Parameters
args{ projectId?: JsonValue }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/auth/github/connection-state
sovaria.api.platform.listEventHooks
GET /api/v1/auth/event-hooks
sovaria.api.platform.listEventHooks(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /api/v1/auth/event-hooks
sovaria.api.platform.resolveErrorTrace
PATCH /api/v1/error-traces/{trace_id}/resolved
sovaria.api.platform.resolveErrorTrace(
args: { traceId: string; resolved: JsonValue },
): Promise<JsonValue>Parameters
args{ traceId: string; resolved: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
PATCH /api/v1/error-traces/{…}/resolved
sovaria.api.policy
sovaria.api.policy.auditCount
Return current audit-entry count.
sovaria.api.policy.auditCount(): Promise<JsonValue>GET /api/v1/audit/count
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/audit/count
sovaria.api.policy.auditVerify
Verify audit hash-chain integrity.
sovaria.api.policy.auditVerify(): Promise<JsonValue>GET /api/v1/audit/verify
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/audit/verify
sovaria.api.policy.policyCreate
Create and compile a policy.
sovaria.api.policy.policyCreate(
args: { policyId: JsonValue; name: JsonValue; splSource: JsonValue; orgId: JsonValue },
): Promise<JsonValue>POST /api/v1/policies/
Parameters
args{ policyId: JsonValue; name: JsonValue; splSource: JsonValue; orgId: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/policies/
sovaria.api.policy.policyDelete
Delete (deactivate) a policy.
sovaria.api.policy.policyDelete(args: { policyId: string }): Promise<JsonValue>DELETE /api/v1/policies/{policy_id}
Parameters
args{ policyId: string }required
- Returns
Promise<JsonValue>- HTTP
DELETE /api/v1/policies/{…}
sovaria.api.policy.policyEvaluate
Evaluate a policy against an explicit debug context.
sovaria.api.policy.policyEvaluate(
args: { policyId: string; context: JsonValue },
): Promise<JsonValue>POST /api/v1/policies/{policy_id}/evaluate
Parameters
args{ policyId: string; context: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/policies/{…}/evaluate
sovaria.api.policy.policyGet
Get a single policy by ID.
sovaria.api.policy.policyGet(args: { policyId: string }): Promise<JsonValue>GET /api/v1/policies/{policy_id}
Parameters
args{ policyId: string }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/policies/{…}
sovaria.api.policy.policyHistory
Return version history for a policy.
sovaria.api.policy.policyHistory(args: { policyId: string }): Promise<JsonValue>GET /api/v1/policies/{policy_id}/history
Parameters
args{ policyId: string }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/policies/{…}/history
sovaria.api.policy.policyList
List active policies visible in current tenant scope.
sovaria.api.policy.policyList(): Promise<JsonValue>GET /api/v1/policies/
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/policies/
sovaria.api.policy.policyRollback
Rollback a policy to a historical version.
sovaria.api.policy.policyRollback(
args: { policyId: string; version: JsonValue },
): Promise<JsonValue>POST /api/v1/policies/{policy_id}/rollback
Parameters
args{ policyId: string; version: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/policies/{…}/rollback
sovaria.api.policy.policyTemplates
List server-authoritative SPL templates.
sovaria.api.policy.policyTemplates(): Promise<JsonValue>GET /api/v1/policies/templates
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/policies/templates
sovaria.api.realtime
sovaria.api.realtime.channels
List active realtime channels.
sovaria.api.realtime.channels(): Promise<JsonValue>GET /api/v1/rt/stream/channels
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/rt/stream/channels
sovaria.api.realtime.presence
Fetch presence for a realtime channel.
sovaria.api.realtime.presence(args: { channel: string }): Promise<JsonValue>GET /api/v1/rt/stream/presence/{channel}
Parameters
args{ channel: string }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/rt/stream/presence/{…}
sovaria.api.realtime.replay
Replay events for a realtime channel.
sovaria.api.realtime.replay(
args: { channel: string; after?: JsonValue; limit?: JsonValue },
): Promise<JsonValue>GET /api/v1/rt/stream/replay/{channel}
Parameters
args{ channel: string; after?: JsonValue; limit?: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/rt/stream/replay/{…}
sovaria.api.realtime.subscribe
Subscribe a client ID to a realtime channel.
sovaria.api.realtime.subscribe(
args: { channel: JsonValue; clientId: JsonValue },
): Promise<JsonValue>POST /api/v1/rt/stream/subscribe
Parameters
args{ channel: JsonValue; clientId: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/rt/stream/subscribe
sovaria.api.realtime.unsubscribe
Unsubscribe a client ID from a realtime channel.
sovaria.api.realtime.unsubscribe(
args: { channel: JsonValue; clientId: JsonValue },
): Promise<JsonValue>POST /api/v1/rt/stream/unsubscribe
Parameters
args{ channel: JsonValue; clientId: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/rt/stream/unsubscribe
sovaria.api.simulation
sovaria.api.simulation.compareRuns
GET /api/v1/sim/runs/{target_run_id}/compare/{baseline_run_id}
sovaria.api.simulation.compareRuns(
args: { targetRunId: string; baselineRunId: string },
): Promise<JsonValue>Parameters
args{ targetRunId: string; baselineRunId: string }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/sim/runs/{…}/compare/{…}
sovaria.api.simulation.discover
POST /api/v1/sim/discover
sovaria.api.simulation.discover(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
POST /api/v1/sim/discover
sovaria.api.simulation.getRun
GET /api/v1/sim/runs/{run_id}
sovaria.api.simulation.getRun(args: { runId: string }): Promise<JsonValue>Parameters
args{ runId: string }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/sim/runs/{…}
sovaria.api.simulation.listRuns
GET /api/v1/sim/runs
sovaria.api.simulation.listRuns(
args?: { limit?: JsonValue; offset?: JsonValue } = {},
): Promise<JsonValue>Parameters
args{ limit?: JsonValue; offset?: JsonValue }optionaldefault{}
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/sim/runs
sovaria.api.storage
sovaria.api.storage.createBucket
POST /api/v1/store/buckets
sovaria.api.storage.createBucket(args: { body: JsonObject }): Promise<JsonValue>Parameters
args{ body: JsonObject }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/store/buckets
sovaria.api.storage.deleteBucket
DELETE /api/v1/store/buckets/{name}
sovaria.api.storage.deleteBucket(args: { name: string }): Promise<JsonValue>Parameters
args{ name: string }required
- Returns
Promise<JsonValue>- HTTP
DELETE /api/v1/store/buckets/{…}
sovaria.api.storage.getBucket
GET /api/v1/store/buckets/{name}
sovaria.api.storage.getBucket(args: { name: string }): Promise<JsonValue>Parameters
args{ name: string }required
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/store/buckets/{…}
sovaria.api.storage.listBuckets
GET /api/v1/store/buckets
sovaria.api.storage.listBuckets(): Promise<JsonValue>- Returns
Promise<JsonValue>- HTTP
GET /api/v1/store/buckets
sovaria.api.storage.moveObject
POST /api/v1/store/objects/move
sovaria.api.storage.moveObject(
args: { fromPath: JsonValue; toPath: JsonValue },
): Promise<JsonValue>Parameters
args{ fromPath: JsonValue; toPath: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/store/objects/move
sovaria.api.storage.updateBucket
PATCH /api/v1/store/buckets/{name}
sovaria.api.storage.updateBucket(args: { name: string; body: JsonObject }): Promise<JsonValue>Parameters
args{ name: string; body: JsonObject }required
- Returns
Promise<JsonValue>- HTTP
PATCH /api/v1/store/buckets/{…}
sovaria.api.vector
sovaria.api.vector.deleteCollection
Delete an entire vector collection.
sovaria.api.vector.deleteCollection(args: { collection: string }): Promise<JsonValue>DELETE /api/v1/collections/{collection}
Parameters
args{ collection: string }required
- Returns
Promise<JsonValue>- HTTP
DELETE /api/v1/collections/{…}
sovaria.api.vector.deleteRecord
Delete a record from a vector collection.
sovaria.api.vector.deleteRecord(
args: { collection: string; recordId: string },
): Promise<JsonValue>DELETE /api/v1/collections/{collection}/records/{record_id}
Parameters
args{ collection: string; recordId: string }required
- Returns
Promise<JsonValue>- HTTP
DELETE /api/v1/collections/{…}/records/{…}
sovaria.api.vector.embed
Generate embeddings for one or more texts.
sovaria.api.vector.embed(args: { texts: JsonValue }): Promise<JsonValue>POST /api/v1/embed
Parameters
args{ texts: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/embed
sovaria.api.vector.listCollections
List vector collections in the current project scope.
sovaria.api.vector.listCollections(): Promise<JsonValue>GET /api/v1/collections
- Returns
Promise<JsonValue>- HTTP
GET /api/v1/collections
sovaria.api.vector.upsert
Embed and upsert documents into a vector collection.
sovaria.api.vector.upsert(args: { collection: JsonValue; docs: JsonValue }): Promise<JsonValue>POST /api/v1/vectors/upsert
Parameters
args{ collection: JsonValue; docs: JsonValue }required
- Returns
Promise<JsonValue>- HTTP
POST /api/v1/vectors/upsert