> ## Documentation Index > Fetch the complete documentation index at: https://docs.omni.co/llms.txt > Use this file to discover all available pages before exploring further. # Omni API versioning > Learn about the versioning strategy for and current status of Omni APIs. Omni APIs are versioned by endpoint. In this reference, endpoints are grouped by resource type. For example, the **AI APIs** section lists the endpoints related to the Omni Agent and other AI features. | Resource | Description | | --------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------- | | [Who am I?](#who-am-i) | Retrieve the authenticated caller's identity, permissions, and API key scope. | | [AI](#ai) | Generate queries from natural language, run AI Agent jobs and routines, manage model suggestions and evals, and configure AI credit controls and branding. | | [API tokens](#api-tokens) | List, inspect, enable or disable, and delete organization API tokens. | | [Connections](#connections) | Create and manage database connections, connection environments, dbt configuration, and schema refresh schedules. | | [Content](#content) | List documents and folders, and export or import dashboards between Omni instances. | | [Dashboards](#dashboards) | Download dashboards and tiles, and manage dashboard filters and controls. | | [Documents](#documents) | Create, draft, publish, and manage documents, including favorites, labels, and permissions. | | [Folders](#folders) | Create and manage folders and their permissions. | | [Labels](#labels) | Create and manage labels for organizing content. | | [Models](#models) | Create and manage semantic models, including branches, Git configuration, topics, views, and YAML files. | | [Queries](#queries) | Run queries and retrieve their results. | | [Schedules](#schedules) | Create and manage scheduled deliveries, including their runs and recipients. | | [Uploads](#uploads) | Upload CSV files as data input tables and manage existing uploads. | | [Users](#users) | Provision and manage users via SCIM, including embed and email-only users, model roles, and user attributes. | | [User groups](#user-groups) | Provision and manage user groups via SCIM and their model roles. | ## Who am I?

Endpoint	Description	Version + Status
[GET /v1/whoami](/api/who-am-i/get-current-identity-and-permissions)	Retrieve the authenticated caller's own identity, API key scope, organization role, and resolved per-model permissions. Supports filtering to specific models.	v1 (latest)

## AI ### Branding

Endpoint	Description	Version + Status
[GET /v1/ai/branding](/api/ai/get-ai-agent-branding)	Return the organization's AI Agent's [branding configuration](/ai/settings/branding), including display name, custom logo URL, and copy for AI Agent landing surfaces.	v1 (latest)

### Conversations

Endpoint	Description	Version + Status
[GET /v1/ai/conversations](/api/ai/list-ai-conversations)	List a user's recent AI conversations, ordered by most-recent activity.	v1 (latest)
[GET /v1/ai/conversations/:conversationId](/api/ai/get-conversation)	Retrieve a conversation with its full message history — alternating user and assistant turns.	v1 (latest)

### Credit Controls

Endpoint	Description	Version + Status
[PATCH /v1/ai/credit-controls/users](/api/ai-credit-controls/set-individual-users-ai-credit-limits)	Set individual users' AI credit limits in bulk.	v1 (latest)
[PATCH /v1/ai/credit-controls](/api/ai-credit-controls/update-ai-credit-controls)	Update the organization's AI credit controls.	v1 (latest)
[GET /v1/ai/credit-controls](/api/ai-credit-controls/get-ai-credit-controls)	Get the organization's current AI credit control settings, usage for the current billing period, and the billing period bounds.	v1 (latest)
[GET /v1/ai/credit-controls/users](/api/ai-credit-controls/list-individual-users-ai-credit-limits)	List the organization's active individual user AI credit limits, ordered by `userId` ascending.	v1 (latest)

### Evals

Endpoint	Description	Version + Status
[POST /v1/ai/eval/prompt-sets](/api/ai-eval/create-an-eval-prompt-set)	Create a new eval prompt set bound to a shared model.	v1 (latest)
[PATCH /v1/ai/eval/prompt-sets/:promptSetId](/api/ai-eval/update-an-eval-prompt-set)	Update a prompt set's name, description, and/or prompts.	v1 (latest)
[GET /v1/ai/eval/prompt-sets](/api/ai-eval/list-eval-prompt-sets)	List eval prompt sets, sorted alphabetically by name.	v1 (latest)
[GET /v1/ai/eval/prompt-sets/:promptSetId](/api/ai-eval/get-an-eval-prompt-set)	Get a single prompt set with all of its prompts.	v1 (latest)
[DELETE /v1/ai/eval/prompt-sets/:promptSetId](/api/ai-eval/archive-an-eval-prompt-set)	Archive (soft-delete) a prompt set.	v1 (latest)
[POST /v1/ai/eval/prompt-sets/:promptSetId/unarchive](/api/ai-eval/restore-an-archived-eval-prompt-set)	Restore an archived prompt set.	v1 (latest)
[POST /v1/ai/eval/runs](/api/ai-eval/start-an-eval-run)	Create and start a new run against an existing prompt set.	v1 (latest)
[GET /v1/ai/eval/runs](/api/ai-eval/list-eval-runs)	List runs for a prompt set, newest first, filtered to runs whose model the caller can access.	v1 (latest)
[GET /v1/ai/eval/runs/:runId](/api/ai-eval/get-an-eval-run)	Get an eval run with every per-prompt result row, including the underlying agentic job state and any scoring data.	v1 (latest)
[POST /v1/ai/eval/runs/:runId/cancel](/api/ai-eval/cancel-an-eval-run)	Cancel an in-progress eval run.	v1 (latest)
[POST /v1/ai/eval/runs/:runId/unarchive](/api/ai-eval/restore-an-archived-eval-run)	Restore an archived eval run.	v1 (latest)
[DELETE /v1/ai/eval/runs/:runId](/api/ai-eval/archive-an-eval-run)	Archive (soft-delete) an eval run.	v1 (latest)

### Model Suggestions

Endpoint	Description	Version + Status
[POST /v1/models/:modelId/suggestions/generate](/api/ai-model-suggestions/generate-model-suggestions)	Trigger an AI suggestion generation run for the shared model and enqueue the async job.	v1 (latest)
[GET /v1/models/:modelId/suggestions](/api/ai-model-suggestions/list-ai-generated-suggestions)	List AI-generated suggestions for a shared model.	v1 (latest)
[POST /v1/models/:modelId/suggestions/:suggestionId/ignore](/api/ai-model-suggestions/dismiss-a-suggestion)	Dismiss a suggestion, removing it from the active list.	v1 (latest)
[POST /v1/models/:modelId/suggestions/:suggestionId/restore](/api/ai-model-suggestions/restore-a-dismissed-suggestion)	Restore a previously dismissed suggestion back to the active list.	v1 (latest)
[DELETE /v1/models/:modelId/suggestions/:suggestionId](/api/ai-model-suggestions/delete-a-suggestion)	Permanently delete a suggestion.	v1 (latest)
[GET /v1/models/:modelId/suggestions/runs/latest](/api/ai-model-suggestions/get-the-latest-generation-run)	Retrieve the most recent generation run for the shared model.	v1 (latest)
[GET /v1/models/:modelId/suggestions/runs/:runId](/api/ai-model-suggestions/get-status-for-a-generation-run)	Retrieve the status of a specific generation run.	v1 (latest)
[PUT /v1/models/:modelId/suggestions/schedule](/api/ai-model-suggestions/enable-model-ai-suggestions-schedule)	Enable the daily generation schedule for AI model suggestions on a shared model.	v1 (latest)
[DELETE /v1/models/:modelId/suggestions/schedule](/api/ai-model-suggestions/disable-model-ai-suggestions-schedule)	Disable the daily generation schedule for AI model suggestions on a shared model.	v1 (latest)

### Queries and jobs

Endpoint	Description	Version + Status
[POST /v1/ai/generate-query](/api/ai/generate-a-query)	Generate a structured Omni query from natural language using AI.	v1 (latest)
[POST /v1/ai/pick-topic](/api/ai/pick-topic)	Analyze a natural language prompt and determine which topic in the model is the best fit for answering the question.	v1 (latest)
[POST /v1/ai/jobs](/api/ai/create-ai-job)	Submit a new AI job for asynchronous execution.	v1 (latest)
[GET /v1/ai/jobs/:jobId](/api/ai/get-ai-job-status)	Retrieve the current status and details of an AI job, including its state, progress information, and result summary.	v1 (latest)
[POST /v1/ai/jobs/:jobId/cancel](/api/ai/cancel-ai-job)	Request cancellation of an AI job.	v1 (latest)
[GET /v1/ai/jobs/:jobId/result](/api/ai/stream-ai-job-results)	Retrieve the full result of a completed AI job, including all actions taken by the AI and the final summarized answer.	v1 (latest)

### Routines

Endpoint	Description	Version + Status
[POST /v1/ai/routines](/api/ai-routines/create-an-ai-routine)	Create a new routine that will run on the specified schedule.	v1 (latest)
[PUT /v1/ai/routines/:routineId](/api/ai-routines/update-an-ai-routine)	Update an existing routine.	v1 (latest)
[GET /v1/ai/routines](/api/ai-routines/list-ai-routines)	List routines for the calling user, newest first.	v1 (latest)
[GET /v1/ai/routines/:routineId](/api/ai-routines/get-an-ai-routine)	Retrieve details for a specific routine by ID, including the status of its most recent completed run.	v1 (latest)
[POST /v1/ai/routines/:routineId/trigger](/api/ai-routines/trigger-ai-routine)	Run an existing routine immediately, in addition to its schedule.	v1 (latest)
[DELETE /v1/ai/routines/:routineId](/api/ai-routines/delete-an-ai-routine)	Delete a routine.	v1 (latest)

## API tokens

Endpoint	Description	Version + Status
[PUT /v1/api-keys/:id](/api/api-tokens/enable-or-disable-api-token)	Disable or re-enable an API token.	v1 (latest)
[GET /v1/api-keys](/api/api-tokens/list-api-tokens)	List API token in the organization - including Organization API keys, Personal Access Tokens, and MCP OAuth grants - with optional filtering by type.	v1 (latest)
[GET /v1/api-keys/:id](/api/api-tokens/retrieve-an-api-token)	Retrieve a single API token by ID.	v1 (latest)
[DELETE /v1/api-keys/:id](/api/api-tokens/delete-api-token)	Permanently delete an API token.	v1 (latest)

## Connections

Endpoint	Description	Version + Status
[POST /v1/connections](/api/connections/create-connection)	Create a new database connection.	v1 (latest)
[PATCH /v1/connections/:connectionId](/api/connections/update-connection)	Update connection properties including credentials.	v1 (latest)
[GET /v1/connections](/api/connections/list-connections)	Retrieve a list of database connections with optional filtering and sorting.	v1 (latest)
[GET /v1/connections/:connectionId](/api/connections/get-connection)	Fetch a single connection by ID.	v1 (latest)
[DELETE /v1/connections/:connectionId](/api/connections/delete-connection)	Archive a connection (moves it to trash).	v1 (latest)

### Connection environments

Endpoint	Description	Version + Status
[POST /v1/connection-environments](/api/connection-environments/create-connection-environments)	Create a connection environment and associate it with a base connection.	v1 (latest)
[PUT /v1/connection-environments/:connectionEnvironmentId](/api/connection-environments/update-connection-environment)	Associate user attribute values with a specific connection environment to determine when the environment is used.	v1 (latest)
[DELETE /v1/connection-environments/:connectionEnvironmentId](/api/connection-environments/delete-connection-environment)	Delete a connection environment by ID.	v1 (latest)

### dbt configuration

Endpoint	Description	Version + Status
[PUT /v1/connections/:connectionId/dbt](/api/dbt/update-dbt-configuration)	Update the dbt configuration for the specified connection.	v1 (latest)
[GET /v1/connections/:connectionId/dbt](/api/dbt/get-dbt-configuration)	Retrieve the dbt configuration for the specified connection.	v1 (latest)
[DELETE /v1/connections/:connectionId/dbt](/api/dbt/delete-dbt-configuration)	Remove the dbt configuration for the specified connection.	v1 (latest)

### dbt environments

Endpoint	Description	Version + Status
[POST /v1/connections/:connectionId/dbt/environments](/api/dbt/create-dbt-environment)	Create a new dbt environment on the specified connection, enabling programmatic environment management.	v1 (latest)
[PUT /v1/connections/:connectionId/dbt/environments/:environmentId](/api/dbt/update-dbt-environment)	Update an existing dbt environment on the specified connection.	v1 (latest)
[GET /v1/connections/:connectionId/dbt/environments](/api/dbt/list-dbt-environments)	Retrieve a list of all dbt environments configured for the specified connection.	v1 (latest)
[DELETE /v1/connections/:connectionId/dbt/environments/:environmentId](/api/dbt/delete-dbt-environment)	Delete an existing dbt environment from the specified connection.	v1 (latest)

### Schema refreshes

Endpoint	Description	Version + Status
[POST /v1/connections/:connectionId/schedules](/api/schema-refresh-schedules/create-schema-refresh-schedule)	Create a new schema refresh schedule for the specified connection.	v1 (latest)
[PUT /v1/connections/:connectionId/schedules/:scheduleId](/api/schema-refresh-schedules/update-schema-refresh-schedule)	Update the schedule and/or timezone for an existing schema refresh schedule.	v1 (latest)
[GET /v1/jobs/:jobId/status](/api/jobs/get-job-status)	Retrieve the current status of an asynchronous job.	v1 (latest)
[GET /v1/connections/:connectionId/schedules](/api/schema-refresh-schedules/list-schema-refresh-schedules)	Retrieve all schema refresh schedules configured for the specified connection.	v1 (latest)
[GET /v1/connections/:connectionId/schedules/:scheduleId](/api/schema-refresh-schedules/get-schema-refresh-schedule)	Retrieve the details of a connection's specific schema refresh schedule.	v1 (latest)
[DELETE /v1/connections/:connectionId/schedules/:scheduleId](/api/schema-refresh-schedules/delete-schema-refresh-schedule)	Delete a schema refresh schedule.	v1 (latest)

## Content

Endpoint	Description	Version + Status
[GET /v1/content](/api/content/retrieve-content)	Retrieve a paginated list of documents and folders.	v1 (latest)
[GET /unstable/documents/:dashboardId/export](/api/content-migration/export-dashboard)	Export a dashboard for migration between Omni instances.	unstable (beta)
[POST /unstable/documents/import](/api/content-migration/import-dashboard)	Import a dashboard to an Omni instance.	unstable (beta)

## Dashboards ### Downloads

Endpoint	Description	Version + Status
[POST /v1/dashboards/:dashboardId/download](/api/dashboard-downloads/initiate-download)	Start an asynchronous download job for a dashboard or single tile with support for multiple output formats.	v1 (latest)
[GET /v1/dashboards/:dashboardId/download/:jobId/status](/api/dashboard-downloads/check-download-status)	Retrieve the current status of a dashboard or tile download job. Poll this endpoint to determine when the file is ready.	v1 (latest)
[GET /v1/dashboards/:dashboardId/download/:jobId](/api/dashboard-downloads/download-file)	Retrieve the completed dashboard or tile download file.	v1 (latest)

### Filters

Endpoint	Description	Version + Status
[PATCH /v1/dashboards/:dashboardId/filters](/api/dashboard-filters/update-dashboard-filterscontrols)	Set or reset values for filters and/or controls on a dashboard.	v1 (latest)
[GET /v1/dashboards/:dashboardId/filters](/api/dashboard-filters/get-dashboard-filters-and-controls)	Retrieve the filter and control configuration for a dashboard.	v1 (latest)

## Documents ### Draft and publish

Endpoint	Description	Version + Status
[POST /v2/documents](/api/documents-v2/create-document)	Create a brand-new document and publish it.	v2 (latest)
[PATCH /v2/documents/:documentId/draft](/api/documents-v2/create-draft-and-patch-document)	Create a new draft on the published document and apply the patch.	v2 (latest)
[PATCH /v2/documents/:documentId/draft/:draftId](/api/documents-v2/patch-draft)	Apply a patch to an existing draft addressed by `draftId`.	v2 (latest)
[POST /v2/documents/:documentId/draft/publish](/api/documents-v2/publish-draft)	Publish the document's current main (non-branch) draft, promoting it to the published version.	v2 (latest)
[POST /v1/documents/:documentId/upgrade](/api/documents/upgrade-dashboard-layout)	Upgrade a classic document to the new dashboard editor.	v1 (latest)
[GET /v2/documents/:documentId](/api/documents-v2/get-document-state)	Read the document's published state.	v2 (latest)
[GET /v1/documents/:documentId/drafts](/api/documents/list-document-drafts)	List all drafts attached to a published document.	v1 (latest)
[GET /v2/documents/:documentId/draft/:draftId](/api/documents-v2/get-draft-state)	Read the named draft's state.	v2 (latest)
[DELETE /v1/documents/:documentId/draft](/api/documents/archive-draft)	Archive the current draft of the specified document.	v1 (latest)
[DELETE /v2/documents/:documentId/draft/:draftId/dashboard](/api/documents/remove-dashboard-from-document)	Remove the dashboard from an existing draft, leaving a workbook-only document.	v2 (latest)
[DELETE /v1/documents/:documentId](/api/documents/delete-document)	Delete document (moves to Trash).	v1 (latest)

### Favorites

Endpoint	Description	Version + Status
[PUT /v1/documents/:documentId/favorite](/api/document-favorites/favorite-document)	Add a document to a user's favorites.	v1 (latest)
[GET /v1/documents/:documentId/favorites](/api/document-favorites/list-document-favoriters)	List users who have favorited a published document, paginated and sorted by `favoritedAt`.	v1 (latest)
[DELETE /v1/documents/:documentId/favorite](/api/document-favorites/unfavorite-document)	Remove a document from a user's favorites.	v1 (latest)

### Labels

Endpoint	Description	Version + Status
[PATCH /v1/documents/:documentId/labels](/api/document-labels/bulk-update-document-labels)	Add and/or remove multiple labels from a document in a single atomic operation.	v1 (latest)
[PUT /v1/documents/:documentId/labels/:labelName](/api/document-labels/apply-label-to-document)	Apply an existing label to a document.	v1 (latest)
[DELETE /v1/documents/:documentId/labels/:labelName](/api/document-labels/remove-label-from-document)	Remove an existing label from a document.	v1 (latest)

### Management

Endpoint	Description	Version + Status
[GET /v1/documents](/api/documents/list-documents)	List documents with pagination and filtering.	v1 (latest)
[PUT /v2/documents/:documentId/identifier](/api/documents-v2/rename-document-identifier)	Rename a published document's identifier.	v2 (latest)
[PUT /v1/documents/:documentId/move](/api/documents/move-document)	Move document to new folder or change scope.	v1 (latest)
[POST /v1/documents/:documentId/duplicate](/api/documents/duplicate-published-document)	Duplicate a published document.	v1 (latest)
[PUT /v1/documents/:documentId/transfer-ownership](/api/documents/transfer-document-ownership)	Transfer ownership of a document to another user in the organization.	v1 (latest)

### Permissions

Endpoint	Description	Version + Status
[POST /v1/documents/:documentId/permissions](/api/document-permissions/grant-document-permissions)	Grant document permissions to users or groups.	v1 (latest)
[PUT /v1/documents/:documentId/permissions](/api/document-permissions/update-document-permission-settings)	Update the permission and [interactivity settings](/share#controlling-document-interactivity) for a document.	v1 (latest)
[PATCH /v1/documents/:documentId/permissions](/api/document-permissions/update-document-permissions)	Update existing document permissions for users or groups.	v1 (latest)
[GET /v1/documents/:documentId/access-list](/api/document-permissions/all-users-and-groups-with-document-access)	List all users and groups with access to a document.	v1 (latest)
[GET /v1/documents/:documentId/permissions](/api/document-permissions/get-document-permissions)	Retrieve the document-level ability values, plus the resolved permits for a specific user when `userId` is provided.	v1 (latest)
[DELETE /v1/documents/:documentId/permissions](/api/document-permissions/revoke-document-permissions)	Revoke document permissions for users or user groups.	v1 (latest)

### Deprecated (v1) The following endpoints are scheduled to be removed on **July 31, 2026**. Use the [v2 document APIs](#documents) instead.

Endpoint	Description	Version + Status
[POST /v1/documents](/api/documents/create-document)	Create a new document.	v1 (deprecated)
[POST /v1/documents/:documentId/draft](/api/documents/create-draft)	Create a [draft](/content/develop/drafts) of the specified document.	v1 (deprecated)
[PUT /v1/documents/:documentId](/api/documents/update-dashboard-document)	Update a document with the specified identifier.	v1 (deprecated)
[PATCH /v1/documents/:documentId](/api/documents/update-document)	Update the name, description, and/or identifier of a document.	v1 (deprecated)
[GET /v1/documents/:documentId/queries](/api/documents/get-document-queries)	Retrieve queries associated with a document by its identifier.	v1 (deprecated)
[GET /v1/documents/:documentId](/api/documents/get-dashboard-document)	Retrieve dashboard document configuration in a format compatible with PUT for round-trip editing.	v1 (deprecated)

## Folders

Endpoint	Description	Version + Status
[GET /v1/folders](/api/folders/list-folders)	Retrieve a paginated list of folders within an organization.	v1 (latest)
[POST /v1/folders](/api/folders/create-folder)	Create a new folder.	v1 (latest)
[PATCH /v1/folders/:folderId](/api/folders/update-folder)	Update a folder's name and/or path segment.	v1 (latest)
[DELETE /v1/folders/:folderId](/api/folders/delete-folder)	Delete a folder.	v1 (latest)

### Permissions

Endpoint	Description	Version + Status
[POST /v1/folders/:folderId/permissions](/api/folder-permissions/grant-folder-permissions)	Grant folder permissions to users or groups.	v1 (latest)
[PATCH /v1/folders/:folderId/permissions](/api/folder-permissions/update-folder-permissions)	Update existing folder permissions for users or groups.	v1 (latest)
[GET /v1/folders/:folderId/permissions](/api/folder-permissions/get-folder-permissions)	Retrieve folder permissions for a user.	v1 (latest)
[DELETE /v1/folders/:folderId/permissions](/api/folder-permissions/revoke-folder-permissions)	Revoke folder permissions from users or groups.	v1 (latest)

## Labels

Endpoint	Description	Version + Status
[POST /v1/labels](/api/labels/create-label)	Create a new label in the organization.	v1 (latest)
[PUT /v1/labels/:labelName](/api/labels/update-label)	Update an existing label.	v1 (latest)
[GET /v1/labels](/api/labels/list-labels)	Retrieve all labels in the organization.	v1 (latest)
[GET /v1/labels/:labelName](/api/labels/get-label)	Retrieve a single label by name.	v1 (latest)
[DELETE /v1/labels/:labelName](/api/labels/delete-label)	Delete a label from the organization.	v1 (latest)

## Models

Endpoint	Description	Version + Status
[POST /v1/models](/api/models/create-model)	Create a new model.	v1 (latest)
[PATCH /v1/models/:modelId](/api/models/rename-model)	Rename a model.	v1 (latest)
[POST /v1/models/:modelId/refresh](/api/models/refresh-schema)	Refresh the schema of the specified model.	v1 (latest)
[GET /v1/models](/api/models/list-models)	Retrieve a paginated list of models with their metadata.	v1 (latest)
[GET /v1/models/:modelId/validate](/api/models/validate-model)	Retrieve validation issues for a model and its branches.	v1 (latest)

### Branches

Endpoint	Description	Version + Status
[POST /v1/models/:modelId/branch/:branchName/merge](/api/model-branches/merge-a-branch)	Merge a model branch into the shared model.	v1 (latest)
[POST /v1/models/:modelId/branch/:branchName/dbt](/api/dbt/set-dbt-environment-on-model-branch)	Set the active dbt environment on a model branch.	v1 (latest)
[DELETE /v1/models/:modelId/branch/:branchName](/api/models/delete-branch)	Delete a branch associated with the specified shared model.	v1 (latest)

### Content validator

Endpoint	Description	Version + Status
[GET /v1/models/:modelId/content-validator](/api/content-validator/validate-content)	Validate all content against the model and return documents with queries and any validation issues.	v1 (latest)
[POST /v1/models/:modelId/content-validator](/api/content-validator/find-and-replace-content)	Perform find/replace operations on content using the specified model.	v1 (latest)

### Management

Endpoint	Description	Version + Status
[GET /v1/models/:modelId/ai-agent-actions](/api/models/get-model-ai-agent-actions)	Return AI agent actions configured for a model.	v1 (latest)
[POST /v1/models/:modelId/cache\_reset/:cachePolicyName](/api/models/reset-cache)	Reset the cache for the specified cache policy.	v1 (latest)
[GET /v1/models/:modelId/schemas](/api/models/list-model-schemas)	Retrieve a sorted list of all available schema names for the specified model, including physical, virtual, and dynamic schemas.	v1 (latest)
[GET /v1/models/:modelId/dbt-exposures](/api/dbt/get-dbt-exposures)	Retrieve dbt exposures for the specified model.	v1 (latest)

### Git

Endpoint	Description	Version + Status
[GET /v1/models/:modelId/git](/api/model-git-configuration/get-git-configuration)	Retrieve the Git configuration for a shared model.	v1 (latest)
[POST /v1/models/:modelId/git](/api/model-git-configuration/create-git-configuration)	Create a new Git configuration for a shared model.	v1 (latest)
[PATCH /v1/models/:modelId/git](/api/model-git-configuration/update-git-configuration)	Update the Git configuration for a shared model.	v1 (latest)
[DELETE /v1/models/:modelId/git](/api/model-git-configuration/delete-git-configuration)	Remove the Git configuration from a shared model.	v1 (latest)
[POST /v1/models/:modelId/git/sync](/api/model-git-configuration/sync-model-with-git-repository)	Trigger a sync operation between the model and its configured Git repository.	v1 (latest)
[POST /v1/models/:modelId/git/commit](/api/model-git-configuration/create-or-update-a-pull-request-for-a-model-branch)	Push a branch's model contents to Git and create or update a pull request.	v1 (latest)
[POST /v1/models/:modelId/migrate](/api/models/migrate-a-model)	Copy a model from one Omni connection to another by reading the source model's YAML at a specific Git ref and writing it to the target model.	v1 (latest)

### Topics

Endpoint	Description	Version + Status
[GET /v1/models/:modelId/topic/:topicName](/api/topics/retrieve-a-topic)	Retrieve a topic in a model by name.	v1 (latest)

### Views

Endpoint	Description	Version + Status
[DELETE /v1/models/:modelId/view/:viewName](/api/models/delete-view)	Delete or ignore a view in a model.	v1 (latest)

### YAML files

Endpoint	Description	Version + Status
[POST /v1/models/:modelId/yaml](/api/models/create-or-update-yaml-files)	Create or overwrite a YAML file for a model.	v1 (latest)
[GET /v1/models/:modelId/yaml](/api/models/get-model-yaml)	Retrieve the YAML representation of a model with optional filtering and mode selection.	v1 (latest)
[DELETE /v1/models/:modelId/yaml](/api/models/delete-a-yaml-file)	Delete a topic or view YAML file from a model.	v1 (latest)

## Queries

Endpoint	Description	Version + Status
[POST /v1/query/run](/api/queries/run-query)	Run the query specified in the request body.	v1 (latest)
[GET /v1/query/wait](/api/queries/wait-for-query-results)	Poll for the results of one or more query jobs.	v1 (latest)

## Schedules

Endpoint	Description	Version + Status
[POST /v1/schedules](/api/schedules/create-schedule)	Create a scheduled task for the specified dashboard.	v1 (latest)
[PUT /v1/schedules/:scheduleId](/api/schedules/update-schedule)	Update the specified task. Changes are applied to future runs; in-progress jobs are unaffected.	v1 (latest)
[PUT /v1/schedules/:scheduleId/transfer-ownership](/api/schedules/transfer-schedule-ownership)	Immediately transfer ownership of a schedule from one user to another user in the same organization.	v1 (latest)
[GET /v1/schedules](/api/schedules/list-schedules)	Retrieve a list of scheduled tasks.	v1 (latest)
[GET /v1/schedules/:scheduleId](/api/schedules/get-schedule)	Return the details of a single schedule, including its delivery destinations, recurrence configuration, and current status.	v1 (latest)
[DELETE /v1/schedules/:scheduleId](/api/schedules/delete-schedule)	Delete a schedule.	v1 (latest)

### Runs

Endpoint	Description	Version + Status
[POST /v1/schedules/:scheduleId/trigger](/api/schedules/trigger-schedule)	Trigger the execution of a schedule on demand.	v1 (latest)
[PUT /v1/schedules/:scheduleId/pause](/api/schedules/pause-schedule)	Pause a schedule.	v1 (latest)
[PUT /v1/schedules/:scheduleId/resume](/api/schedules/resume-schedule)	Resume a schedule.	v1 (latest)

### Recipients

Endpoint	Description	Version + Status
[PUT /v1/schedules/:scheduleId/add-recipients](/api/schedule-recipients/add-schedule-recipients)	Add one or more recipients to an existing scheduled email task.	v1 (latest)
[PUT /v1/schedules/:scheduleId/remove-recipients](/api/schedule-recipients/remove-schedule-recipients)	Remove one or more recipients from an existing scheduled email task.	v1 (latest)
[POST /v1/users/email-only](/api/schedule-recipients/manage-email-only-user)	Create or update an [email-only user](/share/deliveries/email).	v1 (latest)
[POST /v1/users/email-only/bulk](/api/schedule-recipients/bulk-manage-email-only-users)	Create or update up to 20 [email-only users](/share/deliveries/email).	v1 (latest)
[GET /v1/schedules/:scheduleId/recipients](/api/schedule-recipients/list-schedule-recipients)	Retrieve the list of recipients for the specified schedule.	v1 (latest)

## Uploads

Endpoint	Description	Version + Status
[POST /v1/uploads](/api/uploads/upload-a-csv-file)	Upload a CSV file to create a new [data input table](/analyze-explore/data-input-csvs).	v1 (latest)
[GET /v1/uploads](/api/uploads/list-uploads)	List all uploads ([CSV files and spreadsheets](/analyze-explore/data-input-csvs)) in the organization.	v1 (latest)
[DELETE /v1/uploads/:uploadId](/api/uploads/delete-an-upload)	Delete a CSV upload by its ID.	v1 (latest)

## Users

Endpoint	Description	Version + Status
[POST /scim/v2/users](/api/users/create-user)	Create a user.	v2 (latest)
[PUT /scim/v2/users/:userId](/api/users/replace-user)	Replace the specified user.	v2 (latest)
[PATCH /scim/v2/users/:userId](/api/users/update-user)	Update the specified user by applying a list of [SCIM 2.0 patch operations](https://datatracker.ietf.org/doc/html/rfc7644#section-3.5.2).	v2 (latest)
[GET /scim/v2/users/:userId](/api/users/retrieve-user)	Retrieve a user using their unique ID.	v2 (latest)
[GET /scim/v2/users](/api/users/list-users)	Return a list of users, sorted by creation time.	v2 (latest)
[DELETE /scim/v2/users/:userId](/api/users/delete-user)	Delete the specified user.	v2 (latest)

### Email-only users

Endpoint	Description	Version + Status
[GET /v1/users/email-only](/api/users/list-email-only-users)	Retrieve email-only users with their user attributes, with support for cursor-based pagination and filtering.	v1 (latest)

### Embed users

Endpoint	Description	Version + Status
[GET /scim/v2/embed/users](/api/users/list-embed-users)	Retrieve a list of embed users, sorted by creation time.	v2 (latest)
[GET /scim/v2/embed/users/:userId](/api/users/retrieve-embed-user)	Retrieve an embed user using their unique ID.	v2 (latest)
[DELETE /scim/v2/embed/users/:userId](/api/users/delete-embed-user)	Delete the specified embed user.	v2 (latest)

### Model roles

Endpoint	Description	Version + Status
[POST /v1/users/:userId/model-roles](/api/user-model-roles/assign-or-update-user-model-role)	Assign or update a model role for a user.	v1 (latest)
[GET /v1/users/:userId/model-roles](/api/user-model-roles/retrieve-user-model-roles)	Retrieve the model role assignments for a user.	v1 (latest)

### User attributes

Endpoint	Description	Version + Status
[GET /v1/user-attributes](/api/user-attributes/list-user-attributes)	Retrieve all [user attribute](/administration/users/attributes) definitions in the organization, including custom-defined and system-defined attributes.	v1 (latest)

## User groups

Endpoint	Description	Version + Status
[POST /scim/v2/groups](/api/user-groups/create-user-group)	Create a [user group](/administration/users/groups).	v2 (latest)
[PUT /scim/v2/groups/:userGroupId](/api/user-groups/replace-user-group)	Replace the specified user group.	v2 (latest)
[PATCH /scim/v2/groups/:userGroupId](/api/user-groups/update-user-group)	Update the specified user group by applying a list of [v2 patch operations](https://datatracker.ietf.org/doc/html/rfc7644#section-3.5.2).	v2 (latest)
[GET /scim/v2/groups](/api/user-groups/list-user-groups)	Return a list of user groups, sorted by creation time.	v2 (latest)
[GET /scim/v2/groups/:userGroupId](/api/user-groups/retrieve-user-group)	Retrieve a user group using its unique ID.	v2 (latest)
[DELETE /scim/v2/groups/:userGroupId](/api/user-groups/delete-user-group)	Delete the specified user group.	v2 (latest)

### Model roles

Endpoint	Description	Version + Status
[POST /v1/user-groups/:userGroupId/model-roles](/api/user-group-model-roles/assign-or-update-user-group-model-role)	Assign or update a model role for a user group.	v1 (latest)
[GET /v1/user-groups/:userGroupId/model-roles](/api/user-group-model-roles/retrieve-user-group-model-roles)	Retrieve the model role assignments for a user group.	v1 (latest)