Preview the next five schedule occurrences
Validate a schedule and return its next five occurrences after the supplied time. The operation does not create or update a Trail. The calculation skips local times that do not exist and emits an ambiguous local time once.
/trails/schedule/previewValidate a schedule and return its next five occurrences after the supplied time. The operation does not create or update a Trail. The calculation skips local times that do not exist and emits an ambiguous local time once.
In: cookie
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/trails/schedule/preview" \ -H "Content-Type: application/json" \ -d '{ "schedule": { "start": "2026-08-18T10:00:00", "timezone": "string", "rule": { "frequency": "hourly", "interval": 1 } } }'{
"occurrences": [
"2019-08-24T14:15:22Z"
]
}{
"type": "string",
"title": "string",
"detail": "string",
"trace_id": "string",
"metadata": {}
}Create a manual Trail occurrence without moving its schedule POST
Create a new manual run and its action runs immediately. The operation does not change the next scheduled occurrence. An archived Trail cannot start a manual run.
Update a Trail, including pause, resume, finish, or archive PATCH
Replace the mutable Trail definition. The server validates the trigger and action bindings before it saves the update. The creator is immutable. A status change can pause, resume, or archive the Trail. Archive keeps existing run history and does not cancel action runs that already started.