From 3f66aebaa617416d7e531fe1820e25b08b55051e Mon Sep 17 00:00:00 2001 From: Sweets Sweetman Date: Wed, 22 Jul 2026 16:18:49 -0500 Subject: [PATCH 1/2] docs(tasks): document optional timezone on task create/update (chat#1881 3c) Adds the optional IANA `timezone` field to CreateTaskRequest + UpdateTaskRequest (the contract api#780 fulfills). The cron is interpreted in this zone by the Trigger.dev schedule (DST-aware); defaults to UTC; not stored on scheduled_actions. Co-Authored-By: Claude Opus 4.8 (1M context) --- api-reference/openapi/releases.json | 10 ++++++++++ 1 file changed, 10 insertions(+) diff --git a/api-reference/openapi/releases.json b/api-reference/openapi/releases.json index bd31553..565c605 100644 --- a/api-reference/openapi/releases.json +++ b/api-reference/openapi/releases.json @@ -3058,6 +3058,11 @@ "description": "Cron expression defining when the task runs (e.g., '0 9 * * 4' for Thursdays at 9 AM)", "example": "0 9 * * 4" }, + "timezone": { + "type": "string", + "description": "Optional IANA time zone (e.g. America/New_York) the cron schedule is interpreted in, DST-aware. Defaults to UTC. Applied to the Trigger.dev schedule (the source of truth); not stored separately.", + "example": "America/New_York" + }, "account_id": { "type": "string", "format": "uuid", @@ -4114,6 +4119,11 @@ "description": "New cron expression. If sent, must be non-empty and valid for your environment.", "example": "0 10 * * 4" }, + "timezone": { + "type": "string", + "description": "Optional IANA time zone the cron is interpreted in (DST-aware). If sent, updates the Trigger.dev schedule; a timezone-only change re-syncs the schedule. A cron-only update preserves the existing time zone.", + "example": "America/New_York" + }, "account_id": { "type": "string", "format": "uuid", From 6fd8e6fdb75e191f387cd9b0ab7a485f4972850f Mon Sep 17 00:00:00 2001 From: Sweets Sweetman Date: Wed, 22 Jul 2026 16:27:33 -0500 Subject: [PATCH 2/2] docs(tasks): add structured default UTC to create timezone field (chat#1881 3c) Co-Authored-By: Claude Opus 4.8 (1M context) --- api-reference/openapi/releases.json | 1 + 1 file changed, 1 insertion(+) diff --git a/api-reference/openapi/releases.json b/api-reference/openapi/releases.json index 565c605..7d3fbca 100644 --- a/api-reference/openapi/releases.json +++ b/api-reference/openapi/releases.json @@ -3060,6 +3060,7 @@ }, "timezone": { "type": "string", + "default": "UTC", "description": "Optional IANA time zone (e.g. America/New_York) the cron schedule is interpreted in, DST-aware. Defaults to UTC. Applied to the Trigger.dev schedule (the source of truth); not stored separately.", "example": "America/New_York" },