# patch

## HTTP Request

```http
PATCH /api/v1/notebooks/:notebookReference
```

## Path parameters

| Parameter          |                                                                                                                                              |
| ------------------ | -------------------------------------------------------------------------------------------------------------------------------------------- |
| transformReference | A qualified reference to the notebook. See [referencing resources](https://docs.redivis.com/api/referencing-resources) for more information. |

{% hint style="info" %}
This endpoint extends the [general API structure](https://docs.redivis.com/api/rest-api/general-structure)
{% endhint %}

## Request body

Provide a JSON object with information about the notebook.

| Property name   | Type       | Description                                                                                         |
| --------------- | ---------- | --------------------------------------------------------------------------------------------------- |
| **name**        | **string** | The updated name of the notebook. Must be unique (non-word characters ignored) within the workflow. |
| **sourceTable** | **string** | The qualified reference for the notebook's new source table.                                        |

## Authorization

Edit access to the corresponding workflow is required. Your access token must have the following scope:

* workflow\.edit

[Learn more about authorization.](https://docs.redivis.com/api/rest-api/authorization)

## Response body

Returns the JSON-encoded "get" representation of a [notebook resource](https://docs.redivis.com/api/resource-definitions/notebook).
