---
title: "POST /notebooks/{namespace}/{array}/upload"
method: POST
path: "/notebooks/{namespace}/{array}/upload"
tags: ["notebooks"]
---

# POST /notebooks/{namespace}/{array}/upload

`POST /notebooks/{namespace}/{array}/upload`

## Request

- Base URL: `/v2` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/v2/notebooks/{namespace}/{array}/upload`
- Auth: one of:
  - HTTP basic
  - API key in header `X-TILEDB-REST-API-KEY`

Upload a notebook at the specified location and wrap it in TileDB Array

## Request body `application/octet-stream`

- string, binary: Notebook contents

## Response `201`

Notebook uploaded

- NotebookUploaded: Uploaded notebook name and information
  - `output_uri` string: output location of the TileDB Notebook
  - `name` string: name of the notebook uploaded
  - `id` string, required: unique ID of the uploaded notebook

## Other responses

- `502`: Bad Gateway
- `default`: error response

## Changes

- **2023-06-30** (v2) `cc73c130972b`: 1 info
  - endpoint added
- **2023-06-30** (v2) `2d42c7c1a423`: 1 breaking
  - api path removed without deprecation
- **2023-04-11** (v2) `b1880d6f897f`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tiledb/apis/tiledb-storage-platform-api/changes/notebooks/:namespace/:array/upload/post.md)

---

[API](https://skmtc.dev/tiledb/apis/tiledb-storage-platform-api.md) - [All operations](https://skmtc.dev/tiledb/apis/tiledb-storage-platform-api/llms.txt) - [OpenAPI document](https://skmtc.dev/tiledb/apis/tiledb-storage-platform-api/revisions/f9cbeb4407a5?raw)