---
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

---

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