---
title: "Upload a new workbook"
method: POST
path: "/v1/workbooks"
tags: ["workbooks"]
---

# Upload a new workbook

`POST /v1/workbooks`

Upload an Excel workbook file and make it available in the API.

The workbook will be processed in the background. Once it's processed successfully it will be
available for querying and exporting.

## Response `200`

Successful Response

- UploadWorkbookResponse
  - `id` string, required — The id of the newly uploaded workbook

## Other responses

- `400` — Error returned when you make a bad request
- `403` — Error returned when you don't have permission to query a workbook
- `429` — Error returned when you exceed your API rate limit

## Changes

- **2025-03-27** `f9fd5fb43d56` — 2 info
  - the endpoint scheme security `apiKey` was added to the API
  - the endpoint scheme security `HTTPBearer` was removed from the API
- **2025-03-06** `6e9b1263cf6d` — 1 warning
  - removed the request property `filename`
- **2025-03-06** `6cffd1c3020e` — 1 breaking, 1 warning, 1 info
  - removed the media type `application/octet-stream` from the request body
  - deleted the `header` request parameter `X-Uploaded-Filename`
  - added the media type `multipart/form-data` to the request body
- **2025-03-05** `cf876af98da2` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/grid-is/apis/grid-api/changes/v1/workbooks/post.md)

---

[API](https://skmtc.dev/grid-is/apis/grid-api.md) · [All operations](https://skmtc.dev/grid-is/apis/grid-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/grid-is/grid-api/revisions/2f55490ab23d/schema)