API

Updated July 2026

Embrasure API reference.

REST endpoints under https://api.embrasure.ai, version 0.1.0. 475 endpoints across 41 areas.

01

Overview

Base URLhttps://api.embrasure.ai
Request IDsEvery response echoes an x-request-id header. Include it in bug reports; error bodies repeat it as detail.request_id.
Full schemasRequest and response models are published in the OpenAPI spec — browse them at api.embrasure.ai/redoc or consume the typed client, @embrasure/api-client on npm.

02

Authentication

Send a bearer token in the Authorization header: a Supabase session JWT (browser and CLI sign-in) or a workspace-enabled personal access token. SCIM endpoints under /scim/v2 use their own provisioning token. See Identity and sign-in and SCIM provisioning.

03

Errors

Every non-SCIM error uses one envelope:

{
  "detail": {
    "message": "Workspace role is insufficient.",
    "code": "insufficient_workspace_role",
    "hint": "Ask a workspace admin for access.",
    "request_id": "6f4f9be2-…"
  }
}

code is stable and machine-readable — domain codes where a route defines one, otherwise derived from the HTTP status (for example not_found, validation_error, rate_limited). Validation failures carry the field errors in detail.errors.

04

Pagination and rate limits

List endpoints take per-endpoint limit and offset query parameters; there is no global cursor convention yet. There is no global rate limiter today — specific expensive endpoints return 429 with code: "rate_limited", and limits may be introduced without notice, so treat 429 as retryable with backoff.

05

Endpoints

access32 endpointsUnified RBAC: grants, findings, sweeps, and enforcement.
  • GET/v1/access/agent-auditList Access Agent Audit
  • GET/v1/access/agent-audit/exportExport Access Agent Audit
  • GET/v1/access/catalog-permissionsGet Catalog Permissions
  • GET/v1/access/enforcement/actionsList Enforcement Actions
  • GET/v1/access/enforcement/actions/{action_id}Get Enforcement Action
  • POST/v1/access/enforcement/actions/{action_id}/cancelCancel Enforcement
  • POST/v1/access/enforcement/actions/{action_id}/executeExecute Enforcement
  • POST/v1/access/enforcement/planPlan Enforcement
  • GET/v1/access/findingsList Access Findings
  • POST/v1/access/findings/{finding_id}/statusUpdate Access Finding Status
  • GET/v1/access/grantsList Access Grants
  • GET/v1/access/mappingsList Access Mappings
  • PUT/v1/access/mappingsUpsert Access Mapping
  • DELETE/v1/access/mappings/{principal_id}Delete Access Mapping
  • GET/v1/access/objectsList Access Objects
  • GET/v1/access/objects/{securable_id}/accessGet Access Object Entries
  • GET/v1/access/principalsList Access Principals
  • GET/v1/access/principals/{principal_id}Get Access Principal Detail
  • GET/v1/access/requestsList Requests
  • POST/v1/access/requestsCreate Request
  • GET/v1/access/requests/{request_id}Get Request
  • POST/v1/access/requests/{request_id}/cancelCancel Request
  • POST/v1/access/requests/{request_id}/decideDecide Request
  • POST/v1/access/requests/{request_id}/extendExtend Request
  • POST/v1/access/requests/{request_id}/revokeRevoke Request
  • GET/v1/access/requests/countCount Requests
  • GET/v1/access/settingsGet Access Settings
  • PUT/v1/access/settingsUpdate Access Settings
  • GET/v1/access/summaryGet Access Summary
  • POST/v1/access/syncTrigger Access Sync
  • GET/v1/access/sync/statusGet Access Sync Status
  • GET/v1/access/user-mappingsList Access User Mappings
agent55 endpointsData-agent runs, tool calls, and artifacts.
  • GET/v1/agent/contextGet Agent Context
  • POST/v1/agent/databricks-dbt/cleanup-stagingCleanup Databricks Dbt Staging
  • POST/v1/agent/dispatchDispatch Agent
  • GET/v1/agent/github-app/configsList Agent Github App Configs
  • POST/v1/agent/github-app/configsUpsert Agent Github App Config
  • DELETE/v1/agent/github-app/configs/{config_id}Delete Agent Github App Config
  • POST/v1/agent/github-app/configs/{config_id}/validateValidate Agent Github App Config
  • GET/v1/agent/github-app/installationsList Agent Github App Installations
  • POST/v1/agent/github-app/installationsUpsert Agent Github App Installation
  • POST/v1/agent/github-app/installations/{installation_id}/refreshRefresh Agent Github App Installation
  • GET/v1/agent/github-app/installations/{installation_id}/repositoriesList Agent Github App Installation Repositories
  • POST/v1/agent/github-app/installations/callbackComplete Agent Github App Installation Callback
  • POST/v1/agent/github-app/installations/startStart Agent Github App Installation
  • POST/v1/agent/github-app/webhookGithub App Webhook
  • GET/v1/agent/project-connectorsList Agent Project Connectors
  • POST/v1/agent/project-connectorsUpsert Agent Project Connector
  • GET/v1/agent/project-connectors/{provider}/repositoriesList Agent Project Connector Repositories
  • GET/v1/agent/projectsList Agent Projects
  • GET/v1/agent/projects/{project_id}/env-varsList Agent Project Env Vars
  • PUT/v1/agent/projects/{project_id}/env-varsUpsert Agent Project Env Vars
  • GET/v1/agent/projects/{project_id}/filesList Agent Project Files
  • POST/v1/agent/projects/{project_id}/filesCreate Agent Project File
  • GET/v1/agent/projects/{project_id}/files/{file_path}Get Agent Project File
  • PATCH/v1/agent/projects/{project_id}/files/{file_path}Update Agent Project File
  • PUT/v1/agent/projects/{project_id}/git-credentialsUpsert Agent Project Git Credentials
  • GET/v1/agent/projects/{project_id}/lineageList Agent Project Lineage
  • POST/v1/agent/projects/{project_id}/lineage/buildBuild Agent Project Lineage
  • POST/v1/agent/projects/{project_id}/pull-requestsCreate Agent Project Pull Request
  • POST/v1/agent/projects/{project_id}/searchSearch Agent Project
  • PATCH/v1/agent/projects/{project_id}/settingsUpdate Agent Project Settings
  • POST/v1/agent/projects/{project_id}/shell/runRun Agent Project Shell Command
  • POST/v1/agent/projects/{project_id}/shell/suggestSuggest Agent Project Shell Command
  • GET/v1/agent/projects/{project_id}/working-changesList Agent Project Working Changes
  • PUT/v1/agent/projects/{project_id}/working-changesUpsert Agent Project Working Changes
  • POST/v1/agent/projects/syncSync Agent Project
  • POST/v1/agent/runsCreate Authoring Run
  • GET/v1/agent/runs/{tool_run_id}Get Authoring Run
  • POST/v1/agent/runs/{tool_run_id}/approve-planApprove Plan
  • POST/v1/agent/runs/{tool_run_id}/confirm-stepConfirm Step
  • POST/v1/agent/runs/{tool_run_id}/decide-artifactDecide Artifact
  • POST/v1/agent/runs/{tool_run_id}/edit-artifactEdit Artifact
  • POST/v1/agent/runs/{tool_run_id}/follow-upFollow Up Run
  • POST/v1/agent/runs/{tool_run_id}/reject-planReject Plan
  • POST/v1/agent/runs/{tool_run_id}/reject-stepReject Step
  • POST/v1/agent/runs/{tool_run_id}/revise-planRevise Plan
  • POST/v1/agent/runs/{tool_run_id}/tickTick Authoring Run
  • GET/v1/agent/tablesList Agent Tables
  • POST/v1/agent/telemetry-gaps/{tool_run_id}/approve-prApprove Telemetry Gap Pull Request
  • POST/v1/agent/telemetry-gaps/monitor-prsMonitor Telemetry Gap Pull Requests
  • GET/v1/tool-runsList Tool Runs
  • GET/v1/tool-runs/{tool_run_id}Get Tool Run
  • POST/v1/tool-runs/{tool_run_id}/cancelCancel Tool Run
  • GET/v1/tool-runs/{tool_run_id}/statusGet Chat Run Status
  • GET/v1/tool-runs/{tool_run_id}/stepsGet Tool Run Steps
  • POST/v1/tool-runs/by-client-request/{client_request_id}/cancelCancel Tool Run By Client Request
auth16 endpointsSessions, personal access tokens, and identity.
  • POST/v1/auth/oauth/registerRegister Oauth Client
  • POST/v1/auth/oauth/validate-clientValidate Oauth Client
  • GET/v1/auth/scim-tokensList Scim Tokens
  • POST/v1/auth/scim-tokensCreate Scim Token
  • POST/v1/auth/scim-tokens/{token_id}/revokeRevoke Scim Token
  • POST/v1/auth/scim-tokens/{token_id}/rotateRotate Scim Token
  • POST/v1/auth/session/authorizeAuthorize Agent Session
  • POST/v1/auth/session/refreshRefresh Agent Session
  • POST/v1/auth/session/revokeRevoke Current Agent Session
  • POST/v1/auth/session/tokenExchange Agent Session Token
  • GET/v1/auth/sessionsList Workspace Agent Sessions
  • DELETE/v1/auth/sessions/{session_id}Revoke Workspace Agent Session
  • GET/v1/auth/tokensList Agent Tokens
  • POST/v1/auth/tokensCreate Agent Token
  • POST/v1/auth/tokens/{token_id}/revokeRevoke Agent Token
  • GET/v1/auth/whoamiWho Am I
branching5 endpointsWarehouse branch environments and jobs.
  • GET/v1/agent/runs/{run_id}/branchGet Agent Run Branch
  • GET/v1/branching/sourcesList Branch Sources
  • POST/v1/branching/sourcesCreate Branch Source
  • POST/v1/branching/sources/{source_id}/syncSync Branch Source
  • POST/v1/branching/sources/preflightPreflight Branch Source
catalog_sync2 endpointsCatalog metadata sync jobs.
  • GET/v1/catalog-sync/jobsList Jobs
  • POST/v1/catalog-sync/jobsEnqueue Job
catalog-annotations7 endpointsCatalog enrichment and annotations.
  • GET/v1/catalog/annotationsGet Annotations
  • PUT/v1/catalog/annotations/columnsUpsert Columns
  • POST/v1/catalog/annotations/suggestSuggest Annotations
  • GET/v1/catalog/annotations/suggestionsGet Annotation Suggestions
  • POST/v1/catalog/annotations/suggestions/applyApply Suggestions
  • PUT/v1/catalog/annotations/tableUpsert Table
  • POST/v1/catalog/sample-rowsSample Rows
change-events2 endpointsExternal change events (deploys, dbt and pipeline runs) for incident attribution.
  • GET/v1/change-eventsList recorded change events
  • POST/v1/change-eventsRecord an external change event
chat19 endpointsChat-platform integrations (Slack, Teams, Discord, Twilio).
  • GET/v1/chat/discord/installDiscord Install
  • POST/v1/chat/discord/interactionsDiscord Interactions
  • GET/v1/chat/discord/oauth/callbackDiscord Oauth Callback
  • POST/v1/chat/discord/register-commandDiscord Register Command
  • POST/v1/chat/identities/linkLink Chat Identity
  • GET/v1/chat/installsList Installs
  • DELETE/v1/chat/installs/{install_id}Revoke Install
  • GET/v1/chat/installs/{install_id}Get Install
  • GET/v1/chat/installs/{install_id}/channelsList Channel Bindings
  • POST/v1/chat/installs/{install_id}/channelsUpsert Channel Binding
  • DELETE/v1/chat/installs/{install_id}/channels/{binding_id}Delete Channel Binding
  • PATCH/v1/chat/installs/{install_id}/permissionsUpdate Install Permissions
  • POST/v1/chat/slack/commandsSlack Commands
  • POST/v1/chat/slack/eventsSlack Events
  • GET/v1/chat/slack/installSlack Install
  • POST/v1/chat/slack/interactionsSlack Interactions
  • GET/v1/chat/slack/oauth/callbackSlack Oauth Callback
  • POST/v1/chat/twilio/configureTwilio Configure
  • POST/v1/chat/twilio/messagesTwilio Messages
classification6 endpointsData classification and sensitivity.
  • GET/v1/classification/findingsList Classification Findings
  • POST/v1/classification/findings/{finding_id}/undoUndo Classification Finding Route
  • POST/v1/classification/findings/bulkDecide Classification Findings
  • POST/v1/classification/scanTrigger Classification Scan
  • GET/v1/classification/scan/statusGet Classification Scan Status
  • GET/v1/classification/summaryGet Classification Summary
connectors32 endpointsData-source connectors, credentials, and verification.
  • GET/v1/connectorsList Connectors
  • POST/v1/connectorsCreate Connector
  • DELETE/v1/connectors/{connector_id}Delete Connector
  • PATCH/v1/connectors/{connector_id}/agent-availabilityUpdate Connector Agent Availability
  • PATCH/v1/connectors/{connector_id}/autonomous-run-identityUpdate Connector Autonomous Run Identity
  • POST/v1/connectors/{connector_id}/capabilities/checkCheck Connector Capabilities
  • PATCH/v1/connectors/{connector_id}/cost-enrichmentUpdate Connector Cost Enrichment
  • POST/v1/connectors/{connector_id}/cost-enrichment/runTrigger Connector Cost Enrichment
  • PATCH/v1/connectors/{connector_id}/credential-modeUpdate Connector Credential Mode
  • POST/v1/connectors/{connector_id}/credentialsUpsert Connector Credentials
  • GET/v1/connectors/{connector_id}/identity-federationGet Connector Identity Federation
  • POST/v1/connectors/{connector_id}/identity-federation/account-detectionDetect Connector Databricks Account
  • POST/v1/connectors/{connector_id}/identity-federation/actionsIdentity Federation Action
  • PUT/v1/connectors/{connector_id}/identity-federation/enforcementSet Identity Federation Enforcement
  • GET/v1/connectors/{connector_id}/identity-federation/migrationGet Identity Federation Migration
  • POST/v1/connectors/{connector_id}/identity-federation/migrationStart Identity Federation Migration
  • POST/v1/connectors/{connector_id}/identity-federation/setupSetup Connector Identity Federation
  • POST/v1/connectors/{connector_id}/identity-federation/verifyVerify Connector Identity Federation
  • POST/v1/connectors/{connector_id}/keypair-setupSetup Connector Keypair
  • POST/v1/connectors/{connector_id}/query-history/ingestIngest Connector Query History
  • GET/v1/connectors/{connector_id}/user-credentialGet Connector User Credential
  • GET/v1/connectors/{connector_id}/user-oauth-integrationGet Connector User Oauth Integration
  • PUT/v1/connectors/{connector_id}/user-oauth-integrationConfigure Connector User Oauth
  • POST/v1/connectors/{connector_id}/user-oauth/revokeRevoke Connector User Oauth
  • POST/v1/connectors/{connector_id}/user-oauth/startStart Connector User Oauth
  • POST/v1/connectors/{connector_kind}/sync-schemaSync Connector Schema
  • POST/v1/connectors/{connector_kind}/verifyVerify Connector
  • GET/v1/connectors/bigquery/managed-identityGet Managed Bigquery Identity
  • POST/v1/connectors/databricks/warehouses/discoverDiscover Databricks Warehouses
  • GET/v1/oauth/workspaces/{workspace_id}/jwks.jsonGet Workspace Identity Federation Jwks
  • GET/v1/workspaces/{workspace_id}/identity-federation/{connector_id}/public-keyGet Identity Federation Public Key
  • GET/v1/workspaces/{workspace_id}/source-authorizations/meGet My Source Authorizations
context30 endpointsThe unified context graph: objects, evidence, and writes.
  • DELETE/v1/contextDelete Unified Context
  • POST/v1/context/assertions/bulkBulk Context Assertion Action
  • POST/v1/context/assertions/reconcileReconcile Pending Context Assertions
  • POST/v1/context/edges/{edge_id}/verificationSet Unified Context Edge Verification
  • GET/v1/context/graph/overviewGet Unified Context Graph Overview
  • GET/v1/context/inferred-joins/reviewsList Inferred Join Reviews
  • POST/v1/context/inferred-joins/reviewsApply Inferred Join Review
  • GET/v1/context/objectsList Unified Context Objects
  • GET/v1/context/objects/{object_id}Get Unified Context Object
  • POST/v1/context/objects/{object_id}/correctCorrect Unified Context Object
  • GET/v1/context/objects/{object_id}/usageGet Unified Context Object Usage
  • POST/v1/context/objects/{object_id}/verificationSet Unified Context Object Verification
  • GET/v1/context/ontology/healthGet Context Ontology Health
  • GET/v1/context/ontology/objectsList Context Ontology Objects
  • GET/v1/context/ontology/objects/{object_id}Get Context Ontology Object
  • POST/v1/context/ontology/objects/{object_id}/confirmConfirm Context Ontology Object
  • POST/v1/context/ontology/objects/{object_id}/duplicates/dismissDismiss Context Ontology Duplicate Candidate
  • POST/v1/context/ontology/objects/{object_id}/mergeMerge Context Ontology Object
  • POST/v1/context/ontology/proposals/generateGenerate Context Ontology Proposals
  • POST/v1/context/queryQuery Unified Context
  • GET/v1/context/settingsGet Unified Context Settings
  • PATCH/v1/context/settingsPatch Unified Context Settings
  • GET/v1/context/sources/repositoriesList Context Repository Sources
  • POST/v1/context/sources/repositoriesCreate Context Repository Source
  • DELETE/v1/context/sources/repositories/{source_id}Delete Context Repository Source
  • PATCH/v1/context/sources/repositories/{source_id}Update Context Repository Source
  • POST/v1/context/sources/repositories/{source_id}/ingestIngest Context Repository Source
  • POST/v1/context/sources/repositories/{source_id}/verifyVerify Context Repository Source
  • GET/v1/context/statsGet Unified Context Graph Stats
  • POST/v1/context/writeWrite Unified Context
conversations8 endpointsChat conversations and messages.
  • GET/v1/conversationsList Conversations
  • POST/v1/conversationsCreate Conversation
  • GET/v1/conversations/{conversation_id}/messagesList Conversation Messages
  • GET/v1/conversations/{conversation_id}/queriesList Conversation Queries
  • POST/v1/conversations/{conversation_id}/sharesCreate Conversation Share
  • GET/v1/conversations/{conversation_id}/stateGet Conversation State
  • GET/v1/shared/conversations/{token}Get Shared Conversation
  • POST/v1/shared/conversations/{token}/forkFork Shared Conversation
coworker-profile1 endpointThe workspace coworker profile and brief.
  • GET/v1/coworker-profileGet Coworker Profile
dashboard-platform6 endpointsDashboard platform surfaces.
  • GET/v1/dashboard-platform/catalogGet Catalog Dashboard Data
  • GET/v1/dashboard-platform/catalog/autocompleteGet Catalog Autocomplete Data
  • GET/v1/dashboard-platform/catalog/table-detailGet Catalog Table Detail Data
  • GET/v1/dashboard-platform/connectGet Connect Dashboard Data
  • GET/v1/dashboard-platform/context-command-centerGet Context Command Center Data
  • GET/v1/dashboard-platform/context-command-center/progressGet Context Command Center Progress
dashboards36 endpointsDashboards, previews, and sharing.
  • GET/v1/dashboardsList Dashboards
  • POST/v1/dashboardsCreate Dashboard
  • DELETE/v1/dashboards/{dashboard_id}Archive Dashboard
  • GET/v1/dashboards/{dashboard_id}Get Dashboard
  • PATCH/v1/dashboards/{dashboard_id}Update Dashboard
  • GET/v1/dashboards/{dashboard_id}/accessList Dashboard Access Grants
  • PUT/v1/dashboards/{dashboard_id}/accessUpsert Dashboard Access Grant
  • DELETE/v1/dashboards/{dashboard_id}/access/{principal_user_id}Delete Dashboard Access Grant
  • GET/v1/dashboards/{dashboard_id}/auditList Dashboard Audit Events
  • POST/v1/dashboards/{dashboard_id}/cloneClone Dashboard
  • GET/v1/dashboards/{dashboard_id}/dataset-refresh-runsList Dashboard Dataset Refresh Runs
  • GET/v1/dashboards/{dashboard_id}/datasetsList Dashboard Datasets
  • POST/v1/dashboards/{dashboard_id}/datasetsUpsert Dashboard Dataset
  • DELETE/v1/dashboards/{dashboard_id}/datasets/{dataset_key}Delete Dashboard Dataset
  • GET/v1/dashboards/{dashboard_id}/datasets/{dataset_key}/cacheGet Dashboard Dataset Cache
  • POST/v1/dashboards/{dashboard_id}/datasets/{dataset_key}/refreshRefresh Dashboard Dataset
  • POST/v1/dashboards/{dashboard_id}/discard-draftDiscard Dashboard Draft
  • POST/v1/dashboards/{dashboard_id}/exportExport Dashboard
  • GET/v1/dashboards/{dashboard_id}/filters/{filter_id}/optionsDashboard Filter Options
  • GET/v1/dashboards/{dashboard_id}/previewPreview Dashboard
  • POST/v1/dashboards/{dashboard_id}/publishPublish Dashboard
  • POST/v1/dashboards/{dashboard_id}/refreshRefresh Dashboard
  • GET/v1/dashboards/{dashboard_id}/refresh-schedulesList Dashboard Refresh Schedules
  • POST/v1/dashboards/{dashboard_id}/refresh-schedulesUpsert Dashboard Refresh Schedule
  • DELETE/v1/dashboards/{dashboard_id}/refresh-schedules/{schedule_id}Delete Dashboard Refresh Schedule
  • GET/v1/dashboards/{dashboard_id}/sharesList Dashboard Shares
  • POST/v1/dashboards/{dashboard_id}/sharesCreate Dashboard Share
  • DELETE/v1/dashboards/{dashboard_id}/shares/{share_id}Revoke Dashboard Share
  • DELETE/v1/dashboards/{dashboard_id}/starUnstar Dashboard
  • POST/v1/dashboards/{dashboard_id}/starStar Dashboard
  • GET/v1/dashboards/{dashboard_id}/versionsList Dashboard Versions
  • POST/v1/dashboards/{dashboard_id}/versions/{version_number}/restoreRestore Dashboard Version
  • POST/v1/dashboards/{dashboard_id}/viewRecord Dashboard View
  • POST/v1/dashboards/draftDraft Dashboard
  • POST/v1/dashboards/name-suggestionSuggest Dashboard Name Route
  • GET/v1/shared/dashboards/{token}Get Shared Dashboard
data-products5 endpoints
  • GET/v1/data-productsList Data Products
  • POST/v1/data-productsCreate Data Product
  • DELETE/v1/data-products/{data_product_id}Delete Data Product
  • PUT/v1/data-products/{data_product_id}Update Data Product
  • GET/v1/data-products/scoutsList Data Product Scouts
directory15 endpointsWorkspace member directory and provisioning.
  • GET/v1/directory/changes/{change_id}Get Directory Changes
  • POST/v1/directory/changes/{change_id}/approveApprove Directory Changes
  • POST/v1/directory/changes/{change_id}/rejectReject Directory Changes
  • POST/v1/directory/disconnectDisconnect Directory
  • DELETE/v1/directory/entraDisconnect Entra Directory Route
  • POST/v1/directory/entra/connectConnect Entra Directory
  • POST/v1/directory/entra/syncSync Entra Directory Route
  • GET/v1/directory/google/callbackGoogle Directory Oauth Callback
  • POST/v1/directory/google/startStart Google Directory Oauth
  • GET/v1/directory/groupsList Directory Groups
  • PUT/v1/directory/groups/{group_id}/roleUpdate Directory Group Role
  • PUT/v1/directory/settingsUpdate Directory Settings
  • GET/v1/directory/statusGet Directory Status
  • POST/v1/directory/syncSync Directory
  • PUT/v1/directory/users/{directory_user_id}/managementUpdate Directory User Management
governance11 endpointsApproval policies and safeguards.
  • GET/v1/governance/answers/{request_id}/trust-reportGet Answer Trust Report
  • GET/v1/governance/approvalsList Governance Approvals
  • GET/v1/governance/policiesList Governance Policies
  • POST/v1/governance/policiesCreate Governance Policy
  • PATCH/v1/governance/policies/{policy_id}Update Governance Policy
  • POST/v1/governance/policies/simulateSimulate Governance Policy
  • GET/v1/governance/principalsList Governance Principals
  • POST/v1/governance/revealReveal Masked Governed Value
  • GET/v1/governance/settingsGet Governance Settings
  • PATCH/v1/governance/settingsUpdate Governance Settings
  • GET/v1/governance/summaryGet Governance Summary
insights26 endpointsInsight missions, findings, and delivery.
  • POST/v1/insights/ambient/delta-sweepSweep Context Delta Insight Missions
  • GET/v1/insights/ambient/latestGet Latest Ambient Findings
  • POST/v1/insights/ambient/sweepSweep Insight Missions
  • GET/v1/insights/autonomy/policiesList Autonomy Policies
  • POST/v1/insights/autonomy/policiesCreate Autonomy Policy
  • DELETE/v1/insights/autonomy/policies/{policy_id}Delete Autonomy Policy
  • PUT/v1/insights/autonomy/policies/{policy_id}Update Autonomy Policy
  • POST/v1/insights/autonomy/processProcess Autonomy Triggers
  • GET/v1/insights/autonomy/triggersList Autonomy Triggers
  • GET/v1/insights/briefGet Coworker Brief
  • GET/v1/insights/brief/countGet Coworker Brief Count
  • GET/v1/insights/delivery-settingsGet Insight Delivery Settings
  • PUT/v1/insights/delivery-settingsUpdate Insight Delivery Settings
  • POST/v1/insights/digest/process-dueProcess Due Insight Digests
  • POST/v1/insights/discoveryCreate Insight Discovery
  • GET/v1/insights/findings/{finding_id}Get Insight Finding Detail
  • POST/v1/insights/findings/{finding_id}/feedbackCreate Insight Finding Feedback
  • GET/v1/insights/proactiveList Proactive Insights
  • GET/v1/insights/runsList Insight Runs
  • POST/v1/insights/runsCreate Insight Run
  • DELETE/v1/insights/runs/{run_id}Delete Insight Run
  • GET/v1/insights/runs/{run_id}Get Insight Run
  • PATCH/v1/insights/runs/{run_id}Update Insight Run
  • GET/v1/insights/runs/{run_id}/dashboard-previewGet Insight Run Dashboard Preview
  • GET/v1/insights/runs/{run_id}/stateGet Insight Run State
  • POST/v1/insights/runs/{run_id}/tickTick Insight Run
investigations2 endpoints
  • POST/v1/investigationsCreate Investigation
  • POST/v1/visualizations/resolveResolve Visualization
lineage1 endpoint
  • GET/v1/lineage/impactGet Lineage Impact
memories9 endpointsDurable workspace memories.
  • GET/v1/memoriesList Memories
  • POST/v1/memoriesCreate Memory
  • DELETE/v1/memories/{memory_id}Delete Memory
  • PATCH/v1/memories/{memory_id}Update Memory
  • POST/v1/memories/embeddings/reindexReindex Memory Embeddings
  • GET/v1/team-memoriesList Memories
  • POST/v1/team-memoriesCreate Memory
  • DELETE/v1/team-memories/{memory_id}Delete Memory
  • PATCH/v1/team-memories/{memory_id}Update Memory
memory-candidates4 endpointsMemory candidate review.
  • GET/v1/memory-candidatesList Memory Candidates
  • POST/v1/memory-candidates/{candidate_id}/approveApprove Memory Candidate
  • POST/v1/memory-candidates/{candidate_id}/rejectReject Memory Candidate
  • POST/v1/memory-candidates/generateGenerate Candidates
memory-dreams5 endpointsMemory consolidation runs.
  • GET/v1/memory-dreams/itemsList Dream Items
  • POST/v1/memory-dreams/items/{item_id}/dismissDismiss Dream Item
  • POST/v1/memory-dreams/runRun Dream
  • GET/v1/memory-dreams/runsList Dream Runs
  • GET/v1/memory-summaryGet Memory Summary
notebooks9 endpointsNotebooks and cells.
  • GET/v1/notebooksList Notebooks
  • POST/v1/notebooksCreate Notebook
  • DELETE/v1/notebooks/{notebook_id}Archive Notebook
  • GET/v1/notebooks/{notebook_id}Get Notebook
  • PATCH/v1/notebooks/{notebook_id}Update Notebook
  • POST/v1/notebooks/{notebook_id}/execute-cellExecute Notebook Cell
  • POST/v1/notebooks/{notebook_id}/exportExport Notebook
  • GET/v1/notebooks/{notebook_id}/versionsList Notebook Versions
  • POST/v1/notebooks/{notebook_id}/versionsCreate Notebook Version
other1 endpoint
  • GET/healthHealth
overview2 endpointsWorkspace overview and attention feed.
  • GET/v1/overview/attentionGet Overview Attention
  • GET/v1/overview/for-youGet For You
personas4 endpointsObserved user personas.
  • GET/v1/personasList Personas
  • GET/v1/personas/{user_id}Get Persona
  • POST/v1/personas/refreshRefresh Personas
  • GET/v1/personas/table-audienceGet Persona Table Audience
pipelines12 endpointsAgentic dbt and Spark pipelines.
  • GET/v1/pipelinesList Pipelines
  • POST/v1/pipelinesUpsert Pipeline
  • DELETE/v1/pipelines/{pipeline_id}Delete Pipeline
  • GET/v1/pipelines/{pipeline_id}Get Pipeline
  • PATCH/v1/pipelines/{pipeline_id}Update Pipeline
  • POST/v1/pipelines/{pipeline_id}/authorAuthor Pipeline Run
  • POST/v1/pipelines/{pipeline_id}/runTrigger Pipeline Run
  • GET/v1/pipelines/{pipeline_id}/runsList Pipeline Runs
  • POST/v1/pipelines/dbt/manifestIngest Dbt Manifest Endpoint
  • POST/v1/pipelines/lineage/datahubImport Datahub Lineage Endpoint
  • GET/v1/pipelines/runs/{run_id}Get Pipeline Run
  • POST/v1/pipelines/validateValidate Pipeline
plugins3 endpointsMCP and editor integrations.
  • GET/plugins/claude-codeClaude Code Plugin Manifest
  • GET/plugins/codexCodex Plugin Manifest
  • GET/plugins/cursorCursor Plugin Manifest
quality3 endpointsAnswer quality and observability.
  • GET/v1/quality/eval-fixturesList Eval Fixtures
  • GET/v1/quality/observabilityGet Quality Observability
  • GET/v1/quality/query-requests/{request_id}Get Query Quality Report
query11 endpointsNatural-language and SQL query execution.
  • GET/v1/query-request-eventsList Query Request Events
  • GET/v1/query-requestsList Query Requests
  • GET/v1/query-requests/{request_id}Get Query Request
  • GET/v1/query-requests/{request_id}/debugGet Query Request Debug
  • GET/v1/query-requests/{request_id}/detailGet Query Request Detail
  • POST/v1/query-requests/{request_id}/feedbackRecord Query Request Feedback
  • POST/v1/query-requests/{request_id}/result-capsulePromote Query Request Result Capsule
  • POST/v1/query/sqlRun Sql Query
  • GET/v1/result-capsulesList Result Capsules
  • POST/v1/result-capsules/{capsule_id}/statusUpdate Result Capsule Status
  • GET/v1/shared/charts/{request_id}Get Shared Chart
query-insights4 endpointsQuery pattern analysis and suggestions.
  • GET/v1/query-insights/analyticsGet Query Analytics
  • GET/v1/query-insights/suggestionsGet Query Suggestions
  • POST/v1/query-insights/suggestions/scanScan Query Suggestions
  • GET/v1/query-insights/verification-candidatesGet Query Verification Candidates
schema-changes22 endpointsSource schema-change detection and impact.
  • GET/v1/schema-changesList Schema Changes
  • GET/v1/schema-changes/{change_id}Get Schema Change
  • POST/v1/schema-changes/{change_id}/acknowledgeAcknowledge Schema Change
  • GET/v1/schema-changes/{change_id}/impactGet Schema Change Impact
  • GET/v1/table-monitorsList Table Monitors
  • POST/v1/table-monitorsCreate Table Monitor
  • DELETE/v1/table-monitors/{monitor_id}Delete Table Monitor
  • GET/v1/table-monitors/{monitor_id}/checksList Table Monitor Checks
  • POST/v1/table-monitors/{monitor_id}/enabledSet Table Monitor Enabled
  • POST/v1/table-monitors/{monitor_id}/muteMute Table Monitor
  • POST/v1/table-scout-activationsStart Table Scout Activation
  • GET/v1/table-scout-activations/{activation_id}Get Table Scout Activation
  • POST/v1/table-scout-reports/{report_id}/acknowledgeAcknowledge Table Scout Report
  • POST/v1/table-scout-reports/{report_id}/feedbackFeedback Table Scout Report
  • POST/v1/table-scout-reports/{report_id}/resolveResolve Table Scout Report
  • GET/v1/table-scoutsList Table Scouts
  • POST/v1/table-scoutsEnable Table Scout
  • POST/v1/table-scouts/{scout_id}/armArm Table Scout Route
  • POST/v1/table-scouts/{scout_id}/disableDisable Table Scout Route
  • GET/v1/table-scouts/{scout_id}/reportsList Table Scout Reports
  • POST/v1/table-scouts/{scout_id}/run-nowRun Table Scout Now
  • GET/v1/table-scouts/fleetGet Table Scout Fleet
scim17 endpointsSCIM 2.0 provisioning (own auth and error schema).
  • GET/scim/v2/{workspace_id}/GroupsList Groups
  • POST/scim/v2/{workspace_id}/GroupsCreate Group
  • DELETE/scim/v2/{workspace_id}/Groups/{group_id}Delete Group
  • GET/scim/v2/{workspace_id}/Groups/{group_id}Get Group
  • PATCH/scim/v2/{workspace_id}/Groups/{group_id}Patch Group
  • PUT/scim/v2/{workspace_id}/Groups/{group_id}Replace Group
  • GET/scim/v2/{workspace_id}/ResourceTypesList Resource Types
  • GET/scim/v2/{workspace_id}/ResourceTypes/{resource_type_id}Get Resource Type
  • GET/scim/v2/{workspace_id}/SchemasList Schemas
  • GET/scim/v2/{workspace_id}/Schemas/{schema_id}Get Schema
  • GET/scim/v2/{workspace_id}/ServiceProviderConfigService Provider Config
  • GET/scim/v2/{workspace_id}/UsersList Users
  • POST/scim/v2/{workspace_id}/UsersCreate User
  • DELETE/scim/v2/{workspace_id}/Users/{user_id}Delete User
  • GET/scim/v2/{workspace_id}/Users/{user_id}Get User
  • PATCH/scim/v2/{workspace_id}/Users/{user_id}Patch User
  • PUT/scim/v2/{workspace_id}/Users/{user_id}Replace User
semantic8 endpointsSemantic models and definitions.
  • GET/v1/semantic-modelsList Semantic Models
  • GET/v1/semantic-models/{semantic_model_id}Get Semantic Model
  • POST/v1/semantic-models/{semantic_model_id}/embeddings/reindexReindex Model Embeddings
  • GET/v1/semantic-models/{semantic_model_id}/verified-queriesList Verified Queries
  • POST/v1/semantic-models/{semantic_model_id}/verified-queriesCreate Verified Query
  • PATCH/v1/semantic-models/{semantic_model_id}/verified-queries/{query_id}Update Verified Query
  • POST/v1/semantic-models/bootstrapBootstrap Model
  • POST/v1/semantic-models/discovery-debugDebug Semantic Discovery
source-oauth3 endpoints
  • GET/v1/source-oauth/{provider}/callbackFinish Source Oauth
  • POST/v1/source-oauth/{provider}/startStart Source Oauth
  • GET/v1/source-oauth/providersList Source Oauth Providers
warehouse32 endpointsManaged warehouse, databases, and ingestion.
  • GET/v1/workspaces/{workspace_id}/warehouseGet Warehouse
  • POST/v1/workspaces/{workspace_id}/warehouseCreate Warehouse
  • GET/v1/workspaces/{workspace_id}/warehouse/databasesList Databases
  • POST/v1/workspaces/{workspace_id}/warehouse/databasesCreate Database
  • GET/v1/workspaces/{workspace_id}/warehouse/databases/{database}/tablesList Tables
  • GET/v1/workspaces/{workspace_id}/warehouse/databases/{database}/tables/{table}Read Table
  • GET/v1/workspaces/{workspace_id}/warehouse/ingestion-connectionsList Ingestion Connections Route
  • POST/v1/workspaces/{workspace_id}/warehouse/ingestion-connectionsCreate Ingestion Connection Route
  • GET/v1/workspaces/{workspace_id}/warehouse/ingestion-connections/{connection_id}Read Ingestion Connection Route
  • POST/v1/workspaces/{workspace_id}/warehouse/ingestion-connections/{connection_id}/discoverDiscover Ingestion Connection Route
  • POST/v1/workspaces/{workspace_id}/warehouse/ingestion-connections/{connection_id}/pausePause Ingestion Connection Route
  • POST/v1/workspaces/{workspace_id}/warehouse/ingestion-connections/{connection_id}/resumeResume Ingestion Connection Route
  • POST/v1/workspaces/{workspace_id}/warehouse/ingestion-connections/{connection_id}/resyncResync Ingestion Connection Route
  • GET/v1/workspaces/{workspace_id}/warehouse/ingestion-connections/{connection_id}/schema-changesList Ingestion Schema Changes Route
  • POST/v1/workspaces/{workspace_id}/warehouse/ingestion-connections/{connection_id}/tables/{table_id}/schema-changes/{change_id}/dismissDismiss Ingestion Schema Change Summary Route
  • POST/v1/workspaces/{workspace_id}/warehouse/ingestion-connections/{connection_id}/tables/{table_id}/schema-changes/{change_id}/resolveResolve Ingestion Schema Change Route
  • POST/v1/workspaces/{workspace_id}/warehouse/ingestion-connections/preflightPreflight Ingestion Connection Route
  • POST/v1/workspaces/{workspace_id}/warehouse/openapi-connectorsCreate Openapi Connector Route
  • GET/v1/workspaces/{workspace_id}/warehouse/openapi-connectors/{connector_id}Read Openapi Connector Status Route
  • POST/v1/workspaces/{workspace_id}/warehouse/openapi-connectors/{connector_id}/startStart Openapi Connector Route
  • POST/v1/workspaces/{workspace_id}/warehouse/openapi-connectors/previewPreview Openapi Connector Route
  • GET/v1/workspaces/{workspace_id}/warehouse/queriesList Queries
  • POST/v1/workspaces/{workspace_id}/warehouse/queriesCreate Query
  • GET/v1/workspaces/{workspace_id}/warehouse/queries/{query_id}Read Query
  • POST/v1/workspaces/{workspace_id}/warehouse/queries/{query_id}/cancelCancel Query
  • GET/v1/workspaces/{workspace_id}/warehouse/queries/{query_id}/resultsRead Query Results
  • GET/v1/workspaces/{workspace_id}/warehouse/setupGet Managed Warehouse Setup
  • POST/v1/workspaces/{workspace_id}/warehouse/setupSetup Managed Warehouse
  • POST/v1/workspaces/{workspace_id}/warehouse/setup-runsCreate Setup Run
  • GET/v1/workspaces/{workspace_id}/warehouse/setup-runs/{setup_run_id}Get Setup Run
  • PATCH/v1/workspaces/{workspace_id}/warehouse/setup-runs/{setup_run_id}Update Setup Run
  • POST/v1/workspaces/{workspace_id}/warehouse/setup-runs/{setup_run_id}/completeComplete Setup Run
warehouse-waste3 endpoints
  • GET/v1/warehouse-waste/findingsList Warehouse Waste Findings
  • POST/v1/warehouse-waste/findings/{finding_id}/statusUpdate Warehouse Waste Finding Status
  • POST/v1/warehouse-waste/scanScan Warehouse Waste
workspace-usage4 endpointsUsage, spend, and limits.
  • GET/v1/workspace-usageGet Usage Summary
  • GET/v1/workspace-usage/limitsGet Usage Limits
  • PATCH/v1/workspace-usage/limitsUpdate Usage Limits
  • GET/v1/workspace-usage/savingsGet Usage Savings
workspaces2 endpointsWorkspace lifecycle and settings.
  • GET/v1/workspacesList Workspaces
  • POST/v1/workspacesCreate Workspace