Quadratic Sheets API is one of 14 APIs that Quadratic publishes on the APIs.io network, described by a machine-readable OpenAPI specification.
Tagged areas include Sheets. The published artifact set on APIs.io includes an OpenAPI specification and authentication docs.
This API exposes
8 operations
across 6 paths,
and defines 9 schemas.
It is described by OpenAPI 3.1.0, at version 0.26.9.
Requests are made against the base URL https://developer-api.quadratichq.com.
8 operations6 paths9 schemas1 DELETE1 GET3 PATCH3 POST
Metadata
The identity and technical contract details declared by the specification.
Specification
OpenAPI 3.1.0
API Version
0.26.9
Base URL
https://developer-api.quadratichq.com
Authentication
HTTP Bearer
Contact
Quadratic
License
Apache-2.0
Resource Areas
1
Authentication & Security 1
Quadratic Sheets API declares
1 security scheme
for authenticating requests.
It accepts HTTP bearer tokens (API token (qdx_live_… or qdx_test_…)) (bearer_auth).
bearer_auth — API tokens are minted from the Quadratic UI under Team Settings → API Tokens. Send as Authorization: Bearer .
Paths & Operations 8
Across 6 paths, the API surfaces 8 operations — 1 DELETE, 1 GET, 3 PATCH, 3 POST. Each is listed below with its method, path, parameters, and response codes.
Sheets 8
Add, rename, delete, reorder, and recolor sheets.
GET
/v1/files/{file_id}/sheets
Returns info for all sheets, or a single sheet when sheetname is provided. Read-only; dispatches via the worker's /mcp/query route.
listSheets2 params→ 200401502
POST
/v1/files/{file_id}/sheets
Adds a new sheet to the file.
addSheet1 parambody→ 200400401502
PATCH
/v1/files/{file_id}/sheets/colors
Recolors one or more sheet tabs in a single call.
colorSheets1 parambody→ 200400401502
POST
/v1/files/{file_id}/sheets/duplicate
Duplicates an existing sheet under a new name.
duplicateSheet1 parambody→ 200400401502
POST
/v1/files/{file_id}/sheets/move
Reorders sheets within a file.
moveSheet1 parambody→ 200400401502
DELETE
/v1/files/{file_id}/sheets/{sheet_name}
Deletes a sheet by name. Files must always have at least one sheet, so the worker will reject deleting the last remaining sheet.
deleteSheet2 params→ 200400401404502
PATCH
/v1/files/{file_id}/sheets/{sheet_name}
Renames a sheet.
renameSheet2 paramsbody→ 200400401404502
PATCH
/v1/files/{file_id}/sheets/{sheet_name}/frozen
Sets the frozen (pinned) rows and columns for a sheet. Frozen rows always start at row 1 and frozen columns always start at column 1.
setFrozenPanes2 paramsbody→ 200400401404502
Schemas 9
The contract defines 9 schemas that model the data the API accepts and returns. The most detailed are ErrorDetail (3 properties), ColorSheetEntry (2 properties), SetFrozenPanesRequest (2 properties), AddSheetRequest (2 properties). Each schema is shown below with its type and property counts.
ErrorDetail
object
3 properties2 required
SetFrozenPanesRequest
object
2 properties2 required
ColorSheetEntry
object
2 properties2 required
ColorSheetsRequest
object
1 property1 required
RenameSheetRequest
object
1 property1 required
DuplicateSheetRequest
object
2 properties2 required
ErrorBody
object
Canonical error envelope returned by every non-2xx response.
1 property1 required
MoveSheetRequest
object
2 properties1 required
AddSheetRequest
object
2 properties1 required
Specification
The full machine-readable OpenAPI contract behind this narrative.
