# Sheets API

> List, create, and fetch spreadsheet workbooks under /api/sheets.

*[View this page in the Flax docs](https://flax-analytics.com/docs/api-reference/sheets)*

The sheets endpoints manage spreadsheet workbooks built on query results. Listing
and reading need the `read` scope; creating needs `write`.

## List sheets

`GET /api/sheets` — return the sheets the service account can read.

```bash
curl https://flax-analytics.com/api/sheets \
  -H "Authorization: Bearer flax_pat_..."
```

## Create a sheet

`POST /api/sheets` — create a new sheet. Requires the `write` scope.

```bash
curl https://flax-analytics.com/api/sheets \
  -H "Authorization: Bearer flax_pat_..." \
  -H "Content-Type: application/json" \
  -d '{ "name": "Q1 revenue model" }'
```

## Get a sheet

`GET /api/sheets/{sheetId}` — fetch a single sheet by id. Returns `404` if it does
not exist or is not visible to the account.

## Related

- [Sheets overview](/docs/sheets/overview)
- [Errors & limits](/docs/api-reference/errors-and-limits)