Createpresignedurl — Create an embedded url for a project
/v1/embedding/createPresignedUrl/{projectId}
POST
Createproject — Create a new project. Creates a new project in the workspace with the specified title. Optionally provide a description and project language.
/v1/projects
GET
Listprojects — List all viewable projects, sorted by most recently created first.
/v1/projects
GET
Getproject — Get metadata about a single project.
/v1/projects/{projectId}
PATCH
Updateproject — Use this endpoint to add or remove a status (including endorsements) from a project
/v1/projects/{projectId}
GET
Getqueriedtables — Given a project ID, return the list of warehouse tables queried in the project.
/v1/projects/{projectId}/queriedTables
PATCH
Editprojectsharingcollections — Add a project to collections or remove it from collections. For projects, use `CAN_VIEW` to grant the UI permission labeled "Can explore". Use `APP_ONLY` to grant the UI permission labeled "Can view app". Workspace tokens calling this endpo
/v1/projects/{projectId}/sharing/collections
PATCH
Editprojectsharingorgandpublic — Update workspace or public-web sharing for a project. For projects, use `CAN_VIEW` to grant the UI permission labeled "Can explore". Use `APP_ONLY` to grant the UI permission labeled "Can view app".
Editprojectsharinggroups — Add groups to a project or update/remove their project sharing access. For projects, use `CAN_VIEW` to grant the UI permission labeled "Can explore". Use `APP_ONLY` to grant the UI permission labeled "Can view app".
/v1/projects/{projectId}/sharing/groups
PATCH
Editprojectsharingusers — Add users to a project or update/remove their project sharing access. For projects, use `CAN_VIEW` to grant the UI permission labeled "Can explore". Use `APP_ONLY` to grant the UI permission labeled "Can view app".
/v1/projects/{projectId}/sharing/users
POST
Ingestsemanticproject — Ingest a semantic project from a zip file. This API endpoint is subject to a maximum of 3 requests per minute.
Updatesemanticproject — Use this endpoint to add or remove a status (including endorsements) from datasets and views within a semantic project This endpoint uses atomic semantics - if any update in the batch fails validation, the entire request fails and no change
Runproject — Trigger a run of the latest published version of a project. This API endpoint is subject to a maximum of 20 requests per minute and 60 requests per hour.
/v1/projects/{projectId}/runs
GET
Getprojectruns — Get the status of runs of a project. By default, all run types are returned (API-triggered, scheduled, and publish/refresh runs). Use the `runTriggerFilter` parameter to filter to a specific type.
/v1/projects/{projectId}/runs
GET
Getrunstatus — Get the status of a project run.
/v1/projects/{projectId}/runs/{runId}
DELETE
Cancelrun — Cancel a project run.
/v1/projects/{projectId}/runs/{runId}
GET
Getchartimagefromrun — Get the rendered PNG image of a chart cell from a completed run by staticCellId. The "staticId" path parameter should be the cell's staticId (which remains stable across project versions), as opposed to its cellId (which is scoped to a spec
Updatedataconnectionschema — Use this endpoint to add or remove a status (including endorsements) from databases, schemas, and tables within a data connection This endpoint uses atomic semantics - if any update in the batch fails validation, the entire request fails an
/v1/data-connections/{dataConnectionId}/schema
GET
Me — GET /v1/users/me
/v1/users/me
GET
Listusers — GET /v1/users
/v1/users
POST
Deactivateuser — POST /v1/users/{userId}/deactivate
/v1/users/{userId}/deactivate
GET
Getcollection — GET /v1/collections/{collectionId}
Upsertguidedraft — Update or create guide drafts by filePath. Accepts a dictionary mapping file paths to their contents. For each file: - If the guide doesn't exist, it will be created. - If the guide exists but has no draft, a new draft will be created. - If
/v1/guides/draft
POST
Publishguidedrafts — Publish all currently drafted guides.
Listcells — List all cells Returns cells from the draft version of the project only, not the published app. Requires a project id for filtering. For SQL and CODE cells, includes the source code content.
/v1/cells
POST
Createcell — Create a new cell Creates a new cell in the draft version of a project. Currently only CODE and SQL cell types are supported. Requires EDIT_PROJECT_CONTENTS permission on the project.
/v1/cells
GET
Getcell — Get a single cell by ID Returns cells from the draft version of the project only, not the published app. Returns the cell details including id, staticId, cellType, label, dataConnectionId, source contents (for CODE and SQL cells), and proje
/v1/cells/{cellId}
PATCH
Updatecell — Update a cell's source and/or data connection Updates the source code and/or data connection ID for a cell. For SQL cells, can update SQL source and data connection ID. For code cells, can update code source. Requires EDIT_PROJECT_CONTENTS
/v1/cells/{cellId}
DELETE
Deletecell — Delete a cell Permanently deletes a cell from the draft version of a project. Requires EDIT_PROJECT_CONTENTS permission on the project containing the cell.
/v1/cells/{cellId}
GET
Getchartimagefromlogic — Get the rendered PNG image of a chart cell from the current notebook session by cellId. The "cellId" path parameter should be the cell's ID (scoped to a specific version), as opposed to its staticId (which remains stable across versions). R
/v1/cells/{cellId}/image
MCP Tools
createpresignedurl
Create an embedded url for a project
createproject
Create a new project. Creates a new project in the workspace with the specified title. Optionally provide a description and project language.
listprojects
List all viewable projects, sorted by most recently created first.
read-onlyidempotent
getproject
Get metadata about a single project.
read-onlyidempotent
updateproject
Use this endpoint to add or remove a status (including endorsements) from a project
getqueriedtables
Given a project ID, return the list of warehouse tables queried in the project.
read-onlyidempotent
editprojectsharingcollections
Add a project to collections or remove it from collections. For projects, use `CAN_VIEW` to grant the UI permission labeled "Can explore". Use `APP_ONLY` to grant the UI permission labeled "Can view app". Workspace tokens calling this endpo
editprojectsharingorgandpublic
Update workspace or public-web sharing for a project. For projects, use `CAN_VIEW` to grant the UI permission labeled "Can explore". Use `APP_ONLY` to grant the UI permission labeled "Can view app".
editprojectsharinggroups
Add groups to a project or update/remove their project sharing access. For projects, use `CAN_VIEW` to grant the UI permission labeled "Can explore". Use `APP_ONLY` to grant the UI permission labeled "Can view app".
editprojectsharingusers
Add users to a project or update/remove their project sharing access. For projects, use `CAN_VIEW` to grant the UI permission labeled "Can explore". Use `APP_ONLY` to grant the UI permission labeled "Can view app".
ingestsemanticproject
Ingest a semantic project from a zip file. This API endpoint is subject to a maximum of 3 requests per minute.
updatesemanticproject
Use this endpoint to add or remove a status (including endorsements) from datasets and views within a semantic project This endpoint uses atomic semantics - if any update in the batch fails validation, the entire request fails and no change
runproject
Trigger a run of the latest published version of a project. This API endpoint is subject to a maximum of 20 requests per minute and 60 requests per hour.
getprojectruns
Get the status of runs of a project. By default, all run types are returned (API-triggered, scheduled, and publish/refresh runs). Use the `runTriggerFilter` parameter to filter to a specific type.
read-onlyidempotent
getrunstatus
Get the status of a project run.
read-onlyidempotent
cancelrun
Cancel a project run.
idempotent
getchartimagefromrun
Get the rendered PNG image of a chart cell from a completed run by staticCellId. The "staticId" path parameter should be the cell's staticId (which remains stable across project versions), as opposed to its cellId (which is scoped to a spec
read-onlyidempotent
getgroup
GET /v1/groups/{groupId}
read-onlyidempotent
deletegroup
DELETE /v1/groups/{groupId}
idempotent
editgroup
PATCH /v1/groups/{groupId}
listgroups
GET /v1/groups
read-onlyidempotent
creategroup
POST /v1/groups
getdataconnection
GET /v1/data-connections/{dataConnectionId}
read-onlyidempotent
editdataconnection
PATCH /v1/data-connections/{dataConnectionId}
listdataconnections
GET /v1/data-connections
read-onlyidempotent
createdataconnection
POST /v1/data-connections
updatedataconnectionschema
Use this endpoint to add or remove a status (including endorsements) from databases, schemas, and tables within a data connection This endpoint uses atomic semantics - if any update in the batch fails validation, the entire request fails an
me
GET /v1/users/me
read-onlyidempotent
listusers
GET /v1/users
read-onlyidempotent
deactivateuser
POST /v1/users/{userId}/deactivate
getcollection
GET /v1/collections/{collectionId}
read-onlyidempotent
editcollection
PATCH /v1/collections/{collectionId}
listcollections
GET /v1/collections
read-onlyidempotent
createcollection
POST /v1/collections
listdraftguides
GET /v1/guides/draft/list
read-onlyidempotent
upsertguidedraft
Update or create guide drafts by filePath. Accepts a dictionary mapping file paths to their contents. For each file: - If the guide doesn't exist, it will be created. - If the guide exists but has no draft, a new draft will be created. - If
idempotent
publishguidedrafts
Publish all currently drafted guides.
deleteguidedraft
DELETE /v1/guides/draft/{orgGuideFileId}
idempotent
listcells
List all cells Returns cells from the draft version of the project only, not the published app. Requires a project id for filtering. For SQL and CODE cells, includes the source code content.
read-onlyidempotent
createcell
Create a new cell Creates a new cell in the draft version of a project. Currently only CODE and SQL cell types are supported. Requires EDIT_PROJECT_CONTENTS permission on the project.
getcell
Get a single cell by ID Returns cells from the draft version of the project only, not the published app. Returns the cell details including id, staticId, cellType, label, dataConnectionId, source contents (for CODE and SQL cells), and proje
read-onlyidempotent
updatecell
Update a cell's source and/or data connection Updates the source code and/or data connection ID for a cell. For SQL cells, can update SQL source and data connection ID. For code cells, can update code source. Requires EDIT_PROJECT_CONTENTS
deletecell
Delete a cell Permanently deletes a cell from the draft version of a project. Requires EDIT_PROJECT_CONTENTS permission on the project containing the cell.
idempotent
getchartimagefromlogic
Get the rendered PNG image of a chart cell from the current notebook session by cellId. The "cellId" path parameter should be the cell's ID (scoped to a specific version), as opposed to its staticId (which remains stable across versions). R