Snowflake Notebook API

The notebook API from Snowflake — 6 operation(s) for notebook.

Documentation GitHub OpenAPI

Operations 11

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /api/v2/databases/{database}/schemas/{schema}/notebooks List notebooks in a schema · List notebooks #

Ask an LLM

“Which notebooks exist in this schema?”

“Can I see every Snowflake notebook stored in a schema?”

Tell an agent

List all notebooks in schema {schema} of database {database}.

Show me the notebooks stored here.

POST /api/v2/databases/{database}/schemas/{schema}/notebooks Create a notebook · Create a notebook #

Ask an LLM

“How do I create a notebook from a file already sitting in a stage?”

“Can I choose the query warehouse or compute pool a new notebook uses?”

Tell an agent

Create a notebook named {name} in {database}.{schema}.

Create notebook {name} from {fromLocation} with main file {main_file}.

GET /api/v2/databases/{database}/schemas/{schema}/notebooks/{name} Describe a single notebook · Fetch a notebook #

Ask an LLM

“What warehouse, versions and main file does this notebook have?”

“Can I look up the details of one notebook?”

Tell an agent

Describe notebook {name} in {database}.{schema}.

Fetch this notebook's details and versions.

DELETE /api/v2/databases/{database}/schemas/{schema}/notebooks/{name} Delete a notebook · Delete a notebook #

Ask an LLM

“How do I drop a notebook I no longer need?”

“Can a notebook be deleted through the REST API?”

Tell an agent destructive · confirm first

Drop notebook {name} from {database}.{schema}.

Delete the notebook I named.

POST /api/v2/databases/{database}/schemas/{schema}/notebooks/{name}:execute Run a notebook · Execute a Notebook #

Ask an LLM

“Can I run a notebook end to end without opening it?”

“Is there a way to execute a notebook from a script or pipeline?”

Tell an agent

Execute notebook {name} in {database}.{schema}.

Run the notebook I named from start to finish.

POST /api/v2/databases/{database}/schemas/{schema}/notebooks/{name}:rename Rename or move a notebook · Changes the name of the notebook to new name #

Ask an LLM

“How do I rename a notebook?”

“Can I move a notebook to a different database or schema while renaming it?”

Tell an agent

Rename notebook {database}.{schema}.{name} to {targetName}.

Move this notebook to {targetDatabase}.{targetSchema} as {targetName}.

POST /api/v2/databases/{database}/schemas/{schema}/notebooks/{name}:add-live-version Add a LIVE version to a notebook · Adds a LIVE version to the notebook #

Ask an LLM

“Can I create an editable LIVE version of a notebook from its last version?”

“What does adding a live version to a notebook do?”

Tell an agent

Add a LIVE version to notebook {database}.{schema}.{name}.

Add a LIVE version based on the last version ({fromLast}) with comment {comment}.

POST /api/v2/databases/{database}/schemas/{schema}/notebooks/{name}:commit Commit a notebook's LIVE version · Commits the LIVE version of the notebook #

Ask an LLM

“How do I commit my notebook changes to its connected Git repository?”

“Can I name the version and add a message when committing a notebook?”

Tell an agent

Commit the LIVE version of notebook {database}.{schema}.{name}.

Commit this notebook as version {version} with message {comment}.

POST /api/v2/databases/{database}/schemas/{schema}/notebooks/{name}:set-tags Set tags on a notebook · Set tags on a notebook #

Ask an LLM

“How do I tag a notebook?”

“Can I label a notebook with a project tag?”

Tell an agent

Set tags on notebook {database}.{schema}.{name}.

Apply my tag assignments to the notebook I named.

POST /api/v2/databases/{database}/schemas/{schema}/notebooks/{name}:unset-tags Remove tags from a notebook · Unset tags from a notebook #

Ask an LLM

“Can I remove tags from a notebook?”

“What's the way to clear a tag off a notebook?”

Tell an agent

Unset the tags on notebook {database}.{schema}.{name}.

Remove the tag assignments from the notebook I named.

GET /api/v2/databases/{database}/schemas/{schema}/notebooks/{name}:get-tags Get the tags assigned to a notebook · Get the tag assignments for a notebook #

Ask an LLM

“Which tags are assigned to this notebook?”

“Does reading a notebook's tags need an active warehouse?”

Tell an agent

Show every tag assigned to notebook {database}.{schema}.{name}.

List the tag assignments on the notebook I named.

Snowflake Notebook API

Operations 11

Documentation

Specifications

Schemas & Data

Other Resources

Work with this as data

MCP server

Tools for apis

Call it yourself

Get an API key

OpenAPI Specification