API Reference

Base URL:

https://api.flashpoint.ai/v1

All requests require a bearer token. All responses are JSON unless explicitly noted.

Datasets

List datasets

GET /datasets

Query parameters

Name	Type	Default	Description
limit	integer	20	Max items per page. Range: 1–100.
cursor	string	—	Opaque cursor returned in the previous page.

Response

{
  "data": [
    {
      "id": "ds_a1b2c3",
      "name": "Example dataset",
      "created_at": "2026-04-15T12:00:00Z"
    }
  ],
  "has_more": false,
  "next_cursor": null
}

Retrieve a dataset

GET /datasets/{id}

Returns a single dataset. 404 if the ID is unknown or not visible to the calling workspace.

Queries

Run a query

POST /queries

Body

{
  "dataset_id": "ds_a1b2c3",
  "query": "SELECT count(*) FROM rows WHERE created_at > '2026-01-01'"
}

Response — 200

{
  "id": "qry_xyz",
  "status": "succeeded",
  "rows": [{ "count": 42 }]
}

Response — 422

Validation failed. The body is valid JSON, but query could not be planned. See Errors.

Pagination

Cursor-based. Pass the next_cursor from the previous response back in as cursor to fetch the next page. Cursors are opaque — do not parse them.

Rate limits

• Production keys — 600 requests / minute / workspace
• Sandbox keys — 60 requests / minute / workspace

Limit headers are returned on every response:

X-RateLimit-Limit: 600
X-RateLimit-Remaining: 583
X-RateLimit-Reset: 1746230400