Update a Jupyter Notebook

PUT /api/v1.2/jupyter_notebooks/contents/<Path>/<Name>

Use this API to update a jupyter notebook.

Note

This API is not available by default. Create a ticket with Qubole Support to enable this API on your QDS account.

Required Role

The following users can make this API call:

  • Users who belong to the system-user or system-admin group.

  • Users who belong to a group associated with a role that allows update on Jupyter Notebook and directory. See Managing Groups and Managing Roles for more information.

Path Parameters

Parameter

Description

Path

Path of the Jupyter notebook.

Name

Name of the Jupyter notebook including extension (.ipynb).

Parameters

Note

Parameters marked in bold below are mandatory. Others are optional and have default values.

Parameter

Description

type

Type of the document to be updated. Possible value: notebook.

content

Valid jSON of the notebook ipynb.

Example:

{"metadata": {"kernelspec": {"name": "sparkkernel", "display_name": "Spark", "language": ""},
"language_info": {"name": ""}}, "nbformat_minor": 4, "nbformat": 4,
"cells": [{"cell_type": "code", "source": "", "metadata": {}, "execution_count": null, "outputs": []}]}

Request API Syntax

curl -i -X PUT -H "X-AUTH-TOKEN: <token>" -H "Content-Type: application/json" -H "Accept: application/json" \
-d '{"type": "notebook", "content": <ValidNotebookContent>}' \
 "https://api.qubole.com/api/v1.2/jupyter_notebooks/contents/<Path>/<Name>"

Note

The above syntax uses https://api.qubole.com as the endpoint. Qubole provides other endpoints to access QDS that are described in Supported Qubole Endpoints on Different Cloud Providers.

Sample API Request

curl -i -X PUT -H "X-AUTH-TOKEN: $AUTH_TOKEN" -H "Content-Type: application/json" -H "Accept: application/json" \
-d '{"type": "notebook", "content": {"metadata": {"kernelspec": {"name": "sparkkernel", "display_name": "Spark", "language": ""}, "language_info": {"name": ""}}, "nbformat_minor": 4, "nbformat": 4, \
"cells": [{"cell_type": "code", "source": "", "metadata": {}, "execution_count": null, "outputs": []}]}}' \
"https://api.qubole.com/api/v1.2/jupyter_notebooks/contents/Users/[email protected]/note1.ipynb"