GuideLab Docs
Reports

Execute a report query

Runs one adapter-backed, tenant-scoped report query with bounded fields, filters, sorts, pagination, and database time.

POST
/reports/{id}/execute

Runs one adapter-backed, tenant-scoped report query with bounded fields, filters, sorts, pagination, and database time.

Authorization

__Secure-guidelab-prod.session_token<token>

Production session cookie set for the guidelab.co domain by Better Auth

In: cookie

Path Parameters

id*string

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

Response Body

application/json

curl -X POST "https://example.com/reports/string/execute" \  -H "Content-Type: application/json" \  -d '{}'
{  "data": [    {      "property1": null,      "property2": null    }  ],  "columns": [    {      "key": "string",      "label": "string",      "type": "string",      "format": "string",      "aggregation": "sum"    }  ],  "pagination": {    "page": 1,    "limit": 1,    "total": 0,    "totalPages": 0  }}
Empty
Empty
Empty
Empty
Empty
Empty
Empty

Delete a custom report DELETE

Archives a legacy custom report. V2 reports must be archived through PATCH with expectedUpdatedAt. Built-in reports cannot be deleted. Lab owner/admin only.

Export a report as CSV POST

Executes one tenant-scoped report query and returns a synchronous CSV under fixed request, row, byte, time, and query-fan-out ceilings.