Skip to main content
POST
Run SQL against one connected sheet

Authorizations

Authorization
string
header
required

A Dataville API key, sent as Authorization: Bearer dataville_.... Clients that cannot set headers may pass the same key as ?token=.

Path Parameters

id
string
required

The dataset's UUID or its friendly slug (e.g. my-budget-2026).

Body

application/json
sql
string
required
Maximum string length: 10000
Example:

"SELECT * FROM sheet_data LIMIT 10"

Response

Query results.

status
string
Example:

"success"

row_count
integer
rows
object[]
sql_executed
string