exports

Dry-run a recurrence — compute the next N fire times without persisting.

Validates a cron expression or preset and returns the next N fire times in UTC without creating any persistent record. This is the agent "see before committing" tool — call it to confirm a schedule fires at the intended times before calling createExportSchedule. Requires dashboard:write (same gate as create).

Recurrence — cron or preset, not both: Supply exactly one of cron or preset (same XOR rule as createExportSchedule).

timezone: IANA timezone name (default "UTC"). The cron is evaluated in this timezone, but all nextRuns timestamps are returned in UTC (RFC 3339).

count: number of occurrences to return (default 5, clamped 1–20).

Errors: 400 on invalid cron expression, or both/neither of cron/preset supplied. 422 when timezone cannot be resolved to an IANA zone (DVT-4321) — the failing value is echoed in a timezone extension. The detail field describes the exact rejection. 403 if the caller lacks dashboard:write. 404 if the dashboard does not exist or is not visible to the caller.

post/v1/dashboards/{id}/export-schedules/preview

Request

  • Base URL: http://localhost:8080
  • URL: http://localhost:8080/v1/dashboards/{id}/export-schedules/preview
  • Auth: one of:
    • API key in cookie dvt_session
    • HTTP bearer

Request body

cronstring

A canonical 5-field cron expression (validated server-side).

timezonestring

IANA timezone name (e.g. "America/New_York"). Defaults to UTC. A blank value, or "Local", normalizes to "UTC"; any other name that cannot be resolved is a 422.

countinteger

Number of next-fire times to return (clamped to 1–20).

Example request

{
  "cron": "*/15 * * * *"
}

Response

Computed fire times.

Changes

No recorded changes to this operation across all 1 revision of this API.