Admin, Ops & Multi-Tenancy

Operators run backups, restores, and compaction via BackupClient; manage pipelines, feeds, notification rules, jobs, and LLM config via SystemClient; manage tenants, tiers, sharing, and platform usage via TenantAdminClient; and mint/revoke bearer tokens via TokenClient.

46 methods across this domain. Signatures, parameters (incl. keyword-only tunable defaults), and the three SDK spellings are ported from the live SDK source; flagship methods carry a hand-written When to use + example.

BackupClient

restore(snapshot_id, tenant=None, point_in_time_ns=None)

When to use. Restore from a snapshot; poll with wait_for_restore / restore_status.

  • Pythonclient.backupclient.restore(snapshot_id, tenant=None, point_in_time_ns=None)
  • TypeScriptrestore(snapshotId, opts)
  • GoRestore(snapshotID)

Parameters: snapshot_id, tenant=None, point_in_time_ns=None

Example

rid = BackupClient.from_client(relata).restore(snapshot_id="snap-9")

compact()

compact()`

  • Pythonclient.backupclient.compact()
  • TypeScriptcompact()
  • GoCompact()

create(kind='full', tenant=None)

create(kind='full', tenant=None)`

  • Pythonclient.backupclient.create(kind='full', tenant=None)
  • TypeScriptcreate(opts)
  • GoCreate()

Parameters: kind='full', tenant=None

list()

list()`

  • Pythonclient.backupclient.list()
  • TypeScriptlist()
  • GoList()

restore_status(restore_id)

restore_status(restore_id)`

  • Pythonclient.backupclient.restore_status(restore_id)
  • TypeScriptrestoreStatus(restoreId)
  • GoRestoreStatus(restoreID)

Parameters: restore_id

wait_for_restore(restore_id, timeout_secs=300.0, poll_interval_secs=2.0)

wait_for_restore(restore_id, timeout_secs=300.0, poll_interval_secs=2.0)`

  • Pythonclient.backupclient.wait_for_restore(restore_id, timeout_secs=300.0, poll_interval_secs=2.0)
  • TypeScriptwaitForRestore(restoreId, opts)
  • GoWaitForRestore(restoreID)

Parameters: restore_id, timeout_secs=300.0, poll_interval_secs=2.0

RelataClient

cluster_drain(node_id)

cluster_drain(node_id)`

  • Pythonclient.relataclient.cluster_drain(node_id)
  • TypeScriptclusterDrain(nodeId)
  • GoClusterDrain(nodeID)

Parameters: node_id

cluster_nodes()

cluster_nodes()`

  • Pythonclient.relataclient.cluster_nodes()
  • TypeScriptclusterNodes()
  • GoClusterNodes()

cluster_rebalance()

cluster_rebalance()`

  • Pythonclient.relataclient.cluster_rebalance()
  • TypeScriptclusterRebalance()
  • GoClusterRebalance()

cluster_topology()

cluster_topology()`

  • Pythonclient.relataclient.cluster_topology()
  • TypeScriptclusterTopology()
  • GoClusterTopology()

SystemClient

create_notification_rule(rule)

create_notification_rule(rule)`

  • Pythonclient.systemclient.create_notification_rule(rule)
  • TypeScriptcreateNotificationRule(rule)
  • GoCreateNotificationRule(rule)

Parameters: rule

define_pipeline(definition)

define_pipeline(definition)`

  • Pythonclient.systemclient.define_pipeline(definition)
  • TypeScriptdefinePipeline(definition)
  • GoDefinePipeline(definition)

Parameters: definition

delete_notification_rule(rule_id)

delete_notification_rule(rule_id)`

  • Pythonclient.systemclient.delete_notification_rule(rule_id)
  • TypeScriptdeleteNotificationRule(id)
  • GoDeleteNotificationRule(id)

Parameters: rule_id

feed_channels()

feed_channels()`

  • Pythonclient.systemclient.feed_channels()
  • TypeScriptfeedChannels()
  • GoFeedChannels()

feed_health()

feed_health()`

  • Pythonclient.systemclient.feed_health()
  • TypeScriptfeedHealth()
  • GoFeedHealth()

feed_publish(channel, payload)

feed_publish(channel, payload)`

  • Pythonclient.systemclient.feed_publish(channel, payload)
  • TypeScriptfeedPublish(channel, payload)
  • GoFeedPublish(channel, payload)

Parameters: channel, payload

get_workflow(name)

get_workflow(name)`

  • Pythonclient.systemclient.get_workflow(name)
  • TypeScriptgetWorkflow(name)
  • GoGetWorkflow(name)

Parameters: name

job_status(name)

job_status(name)`

  • Pythonclient.systemclient.job_status(name)
  • TypeScriptjobStatus(name)
  • GoJobStatus(name)

Parameters: name

jobs_status()

jobs_status()`

  • Pythonclient.systemclient.jobs_status()
  • TypeScriptjobsStatus()
  • GoJobsStatus()

list_pipelines()

list_pipelines()`

  • Pythonclient.systemclient.list_pipelines()
  • TypeScriptlistPipelines()
  • GoListPipelines()

list_workflows()

list_workflows()`

  • Pythonclient.systemclient.list_workflows()
  • TypeScriptlistWorkflows()
  • GoListWorkflows()

llm_config()

llm_config()`

  • Pythonclient.systemclient.llm_config()
  • TypeScriptllmConfig()
  • GoLLMConfig()

notification_rules()

notification_rules()`

  • Pythonclient.systemclient.notification_rules()
  • TypeScriptnotificationRules()
  • GoNotificationRules()

register_workflow(name, steps)

register_workflow(name, steps)`

  • Pythonclient.systemclient.register_workflow(name, steps)
  • TypeScriptregisterWorkflow(name, steps)
  • GoRegisterWorkflow(name, steps)

Parameters: name, steps

run_workflow(name)

run_workflow(name)`

  • Pythonclient.systemclient.run_workflow(name)
  • TypeScriptrunWorkflow(name)
  • GoRunWorkflow(name)

Parameters: name

test_llm(prompt, model=None)

test_llm(prompt, model=None)`

  • Pythonclient.systemclient.test_llm(prompt, model=None)
  • TypeScripttestLlm(prompt, opts)
  • GoTestLLM(prompt)

Parameters: prompt, model=None

workflow_run(run_id)

workflow_run(run_id)`

  • Pythonclient.systemclient.workflow_run(run_id)
  • TypeScriptworkflowRun(runId)
  • GoWorkflowRun(runID)

Parameters: run_id

workflow_status(name)

workflow_status(name)`

  • Pythonclient.systemclient.workflow_status(name)
  • TypeScriptworkflowStatus(name)
  • GoWorkflowStatus(name)

Parameters: name

TenantAdminClient

create_sharing(tenant_id, partner_tenant, object_type, action='read', expires_ns=None)

When to use. Establish a governed cross-tenant data-sharing agreement.

  • Pythonclient.tenantadminclient.create_sharing(tenant_id, partner_tenant, object_type, action='read', expires_ns=None)
  • TypeScriptcreateSharing(tenantId, partnerTenant, opts)
  • GoCreateSharing(tenantID, partnerTenant, objectType)

Parameters: tenant_id, partner_tenant, object_type, action='read', expires_ns=None

Example

TenantAdminClient.from_client(relata).create_sharing("acme", partner_tenant="beta")

set_tier(tenant_id, tier)

When to use. Move a tenant between tiers (operator surface, cluster-only multi-tenant).

  • Pythonclient.tenantadminclient.set_tier(tenant_id, tier)
  • TypeScriptsetTier(tenantId, tier)
  • GoSetTier(tenantID, tier)

Parameters: tenant_id, tier

Example

TenantAdminClient.from_client(relata).set_tier("acme", tier="enterprise")

create(tenant_id, tier='standard', **fields)

create(tenant_id, tier='standard', **fields)`

  • Pythonclient.tenantadminclient.create(tenant_id, tier='standard', **fields)
  • TypeScriptcreate(tenantId, opts)
  • GoCreate(tenantID)

Parameters: tenant_id, tier='standard', **fields

delete(tenant_id)

delete(tenant_id)`

  • Pythonclient.tenantadminclient.delete(tenant_id)
  • GoDelete(tenantID)

Parameters: tenant_id

get(tenant_id)

get(tenant_id)`

  • Pythonclient.tenantadminclient.get(tenant_id)
  • TypeScriptget(tenantId)
  • GoGet(tenantID)

Parameters: tenant_id

list_sharing(tenant_id)

list_sharing(tenant_id)`

  • Pythonclient.tenantadminclient.list_sharing(tenant_id)
  • TypeScriptlistSharing(tenantId)
  • GoListSharing(tenantID)

Parameters: tenant_id

me()

me()`

  • Pythonclient.tenantadminclient.me()
  • TypeScriptme()
  • GoMe()

platform_license()

platform_license()`

  • Pythonclient.tenantadminclient.platform_license()
  • TypeScriptplatformLicense()
  • GoPlatformLicense()

platform_usage()

platform_usage()`

  • Pythonclient.tenantadminclient.platform_usage()
  • TypeScriptplatformUsage()
  • GoPlatformUsage()

reactivate(tenant_id)

reactivate(tenant_id)`

  • Pythonclient.tenantadminclient.reactivate(tenant_id)
  • TypeScriptreactivate(tenantId)
  • GoReactivate(tenantID)

Parameters: tenant_id

set_quota(tenant_id, quota)

set_quota(tenant_id, quota)`

  • Pythonclient.tenantadminclient.set_quota(tenant_id, quota)
  • TypeScriptsetQuota(tenantId, quota)
  • GoSetQuota(tenantID, quota)

Parameters: tenant_id, quota

suspend(tenant_id)

suspend(tenant_id)`

  • Pythonclient.tenantadminclient.suspend(tenant_id)
  • TypeScriptsuspend(tenantId)
  • GoSuspend(tenantID)

Parameters: tenant_id

tenant_usage(tenant_id)

tenant_usage(tenant_id)`

  • Pythonclient.tenantadminclient.tenant_usage(tenant_id)
  • TypeScripttenantUsage(tenantId)
  • GoTenantUsage(tenantID)

Parameters: tenant_id

usage()

usage()`

  • Pythonclient.tenantadminclient.usage()
  • TypeScriptusage()
  • GoUsage()

TokenClient

check(token_id)

check(token_id)`

  • Pythonclient.tokenclient.check(token_id)
  • TypeScriptcheck(tokenId)
  • GoCheck(tokenID)

Parameters: token_id

remember(token_id, ttl_secs=None)

remember(token_id, ttl_secs=None)`

  • Pythonclient.tokenclient.remember(token_id, ttl_secs=None)
  • TypeScriptremember(tokenId, opts)
  • GoRemember(tokenID)

Parameters: token_id, ttl_secs=None

revoke(token_id)

revoke(token_id)`

  • Pythonclient.tokenclient.revoke(token_id)
  • TypeScriptrevoke(tokenId)
  • GoRevoke(tokenID)

Parameters: token_id

stats()

stats()`

  • Pythonclient.tokenclient.stats()
  • TypeScriptstats()
  • GoStats()