CredVault

SDK Platform Coverage

CredVault SDKs call the same backend as the dashboard and CIE. Use them from your own services and scripts — they are not a pixel-perfect clone of every UI screen.

Pick a door:

JobPrefer
Click and exploreDashboard
Terminal / ML opsCIE CLI
App codeSDK (this page)
Raw HTTPREST API / /api-docs

How The SDK Fits

Create a client and call resources such as data, cie, functions, webhooks, logs, plus platform helpers (notebooks, orchestration, lineage, metadata, pipelines, …) where your package version exposes them.

Best fits:

  • backend services reading/writing CredVault data
  • jobs that manage backups, functions, triggers, webhooks
  • CIE model train/predict from application code
  • CI scripts and workers

Workspace UIs (Notebook, ML Experiments, Orchestration, Lineage, Metadata, Omnigent, Team Management) stay dashboard-first; SDKs expose HTTP-capable pieces, not every visual screen.

Main Dashboard Areas

Sidebar areaWhat users do thereSDK status
DashboardWorkspace homePartly via metrics, logs, clusters
NotebookInteractive notebooksnotebooks where available
OmnigentGoverned agent workspaceDashboard; related agentSessions where available
ML ExperimentsExperiment / model UIDashboard-first; CIE via cie
System MonitoringMetrics, dashboards, alertsmetrics, dashboards, alerts, logs, realtime
OrchestrationJobs / datasets / events UIorchestration, pipelines
LineageAssets / runs / dependencies UIlineage (+ metadata lineage helpers)
Database ClustersClusters and collectionsdata, schema, backups, functions, triggers
MetadataCatalog / governance UImetadata
API KeysCreate and revoke keysapiKeys / api_keys
Activity LogsAudit traillogs
MigrationsImport / export connectionsNot in current SDKs
Billing & PlansPlan and invoicesPrefer dashboard or CIE billing
Team ManagementUsers and rolesDashboard / Team Management UI

Current SDK Resource Map

The Node.js, Python, Go, and Java SDKs follow the same resource layout.

SDK resourceWhat it doesBest credential
authSign up, sign in, and start user-authenticated sessionsEmail/password or user token
dataQuery, insert, update, and delete collection documents; list clustersAPI key for /api/v1/data; user token for cluster list
cieUpload datasets, list datasets, train models, list models, run predictionsUser token
webhooksCreate, update, delete, test, and inspect webhook deliveriesUser token
functionsCreate, update, delete, test, execute, and read function logsUser token
triggersManage cluster and collection trigger automationUser token
backupsCreate, restore, delete, and inspect backup stateUser token
schemaAnalyze cluster schema and collection indexesUser token
apiKeys / api_keysList, create, revoke, and delete API keysUser token with owner/admin workspace role
metricsRead realtime, performance, security, and active collection metricsUser token
logsRead, filter, export, and summarize activity logsUser token
notificationsList, mark read, mark all read, and delete notificationsUser token
settingsIntended for account settings; current backend coverage is limitedUser token
robotsIntended for robot/device APIs; current backend route shape differsUser token
orchestrationList jobs, runs, assets, sensors, schedules, and launch orchestration jobs through CredVaultUser token
lineageList namespaces, datasets, jobs, runs, versions, search metadata, and inspect lineageUser token
metadataList/search tables and databases and inspect metadata lineageUser token
notebooksCreate, update, execute, export, checkpoint, undo, and redo CredVault notebooksUser token
pipelinesCreate, update, run, and inspect pipeline execution historyUser token
dashboardsCreate dashboards, add visualizations, and fetch dashboard dataUser token
alertsCreate alerts, record metrics, and read alert historyUser token
realtimeList/stop realtime streams and build WebSocket stream URLsUser token
agentSessions / agent_sessionsCreate agent sessions and send session events through CredVault authUser token

Platform Integration Examples

Node.js:

JavaScript
const jobs = await credvault.orchestration.listJobs();
const run = await credvault.orchestration.runJob("daily_customer_refresh");

const lineage = await credvault.lineage.getLineage({
  nodeId: "dataset:customers",
  depth: 3,
  direction: "DOWNSTREAM",
});

const tables = await credvault.metadata.search({ q: "customers" });
const execution = await credvault.pipelines.run("pipeline-id");
const dashboardData = await credvault.dashboards.data("dashboard-id");

Python:

Python
jobs = client.orchestration.list_jobs()
run = client.orchestration.run_job("daily_customer_refresh")

lineage = client.lineage.get_lineage(
    node_id="dataset:customers",
    depth=3,
    direction="DOWNSTREAM",
)

tables = client.metadata.search("customers")
execution = client.pipelines.run("pipeline-id")
dashboard_data = client.dashboards.data("dashboard-id")

Java:

java
String jobs = client.platform.orchestration.listJobs();
String run = client.platform.orchestration.runJob("daily_customer_refresh");
String tables = client.platform.metadata.search("customers", 10);

Go:

go
jobs, err := cv.Orchestration.ListJobs()
run, err := cv.Orchestration.RunJob("daily_customer_refresh")
tables, err := cv.Metadata.Search("customers", 10)

Production Base URL

The SDK source defaults to a local development server:

Example
http://localhost:5000/api

Production applications must pass the deployed CredVault backend API URL:

Example
https://<your-credvault-backend>/api

If a production app does not set the base URL, it will try to call the user's own computer and the request will fail.

API Keys And User Tokens

CredVault uses two different credential types.

Use an API key when your backend service needs direct data access:

Terminal
Test in API explorer
curl https://<your-credvault-backend>/api/v1/data/customers \
  -H "X-API-Key: <your-api-key>"
What you should seeA JSON response, an HTTP status, or a clear authentication or permission error.

Use a user token when the action belongs to a signed-in dashboard user, such as managing clusters, functions, webhooks, API keys, logs, settings, or billing-related account state.

What Is Ready For SDK Use

These areas are the best fit for SDK-based development today:

  • application data access through /api/v1/data
  • cluster discovery through authenticated user sessions
  • CIE datasets, model training, model listing, and predictions
  • webhooks
  • serverless functions
  • triggers
  • backups
  • schema and indexes
  • API key lifecycle operations
  • metrics
  • activity logs
  • basic notifications
  • orchestration jobs, runs, assets, sensors, and schedules
  • lineage namespaces, datasets, jobs, runs, versions, search, and lineage graph queries
  • metadata tables, databases, search, and metadata lineage
  • CredVault notebook operations
  • pipelines, dashboards, alerts, realtime stream management, and agent session/event calls

These are the features a developer building on CredVault should start with.

What Should Stay Dashboard Or REST API First

These areas are platform features, but they should not be presented as fully covered by the current SDKs yet:

  • team and workspace member administration
  • migrations and external connection testing
  • billing, invoices, credits, and payment methods
  • Pragma IDE
  • advanced experiment tracking beyond the core SDK helpers

Users can still use these features in the dashboard or through documented REST APIs where available.

Use this wording when describing the SDKs:

CredVault SDKs let developers build applications and automation on top of CredVault data, CIE, functions, webhooks, triggers, backups, schema, metrics, logs, API keys, notebooks, pipelines, dashboards, alerts, orchestration, lineage, metadata, realtime streams, and agent sessions.

Avoid saying:

The SDKs control every CredVault product and dashboard feature.

That would be inaccurate because some product areas are dashboard-first or integration-first today.

Choosing The Right Tool

GoalRecommended tool
Build an app that reads and writes CredVault dataSDK or REST API
Connect a backend service to CredVaultSDK with API key
Run data and AI workflows from a terminalCIE CLI
Manage workspace users and billingDashboard
Explore Notebook, Metadata, Lineage, or Orchestration UIsDashboard sidebar
Call those surfaces from codeSDK helpers where available
Build a custom integration not covered by the SDKREST API
Install and use PragmaPragma product pages and documentation

The SDK should be presented as a developer acceleration layer for the stable core platform APIs. The dashboard remains the main place for broad platform management.