ReferenceSchedulers
List schedulers
List all schedulers with pagination, search, sorting, and filtering
GET/api/v1/schedulers/{projectUuid}/list
Authentication: personal access token. The spec defines an api_key security
scheme — send an Authorization: ApiKey <your-personal-access-token> header
(value format: ApiKey <your key>). A session_cookie scheme (connect.sid)
exists for browser sessions. Operations in this spec declare security: [], an
artifact of the upstream spec generator — authentication is still enforced by the
server.
Path parameters
| Name | Type | Required | Description |
|---|---|---|---|
projectUuid | string | Yes |
Query parameters
| Name | Type | Required | Description |
|---|---|---|---|
pageSize | number | No | number of items per page |
page | number | No | page number |
searchQuery | string | No | search query to filter schedulers by name |
sortBy | string | No | column to sort by |
sortDirection | string | No | sort direction (asc or desc) |
createdByUserUuids | string | No | filter by creator user UUIDs (comma-separated) |
formats | string | No | filter by scheduler formats (comma-separated) |
resourceType | string | No | filter by resource type (chart or dashboard) |
resourceUuids | string | No | filter by resource UUIDs (comma-separated) |
destinations | string | No | filter by destination types (comma-separated: email, slack, msteams, googlechat) |
includeLatestRun | boolean | No |
Responses
200 — Success
{
"results": {
"pagination": {
"page": 0,
"pageSize": 0,
"totalResults": 0,
"totalPageCount": 0
},
"data": [
{
"projectName": "string",
"projectUuid": "string",
"plainTextEmail": true,
"includeLinks": true,
"notificationFrequency": "always",
"enabled": true,
"thresholds": [
{
"value": 0,
"fieldId": "string",
"operator": "greaterThan"
}
],
"options": {
"xlsxFileLayout": "zip",
"exportPivotedData": true,
"asAttachment": true,
"limit": 0,
"formatted": true
},
"appName": "string",
"appUuid": null,
"savedSqlName": "string",
"savedSqlUuid": null,
"dashboardName": "string",
"dashboardUuid": null,
"savedChartName": "string",
"savedChartUuid": "string",
"projectSchedulerTimezone": "string",
"timezone": "string",
"cron": "string",
"format": "csv",
"createdByName": "string",
"createdBy": "string",
"updatedAt": "2024-01-01T00:00:00.000Z",
"createdAt": "2024-01-01T00:00:00.000Z",
"message": "string",
"name": "string",
"slug": "string",
"schedulerUuid": "string",
"parameters": {
"property": "string"
},
"filters": {
"tableCalculations": {
"or": [
{}
],
"id": "string"
},
"metrics": {
"or": [
{}
],
"id": "string"
},
"dimensions": {
"or": [
{}
],
"id": "string"
}
},
"latestRun": {
"format": "csv",
"createdByUserName": "string",
"createdByUserUuid": "string",
"resourceName": "string",
"resourceUuid": "string",
"resourceType": "chart",
"logCounts": {
"error": 0,
"completed": 0,
"started": 0,
"scheduled": 0,
"total": 0
},
"details": {},
"createdAt": "2024-01-01T00:00:00.000Z",
"runStatus": "completed",
"status": "scheduled",
"scheduledTime": "2024-01-01T00:00:00.000Z",
"schedulerName": "string",
"schedulerUuid": "string",
"runId": "string"
},
"targets": [
{
"channel": "string",
"schedulerUuid": "string",
"updatedAt": "2024-01-01T00:00:00.000Z",
"createdAt": "2024-01-01T00:00:00.000Z",
"schedulerSlackTargetUuid": "string"
}
]
}
]
},
"status": "ok"
}default — Error
{
"error": {
"data": "string",
"message": "string",
"name": "string",
"statusCode": 0
},
"status": "error"
}