Configure the daily sync time and/or timezone for all accounts in the selected Workspace.

Requires write or mcp:use scope. Available on every plan. Omitted fields stay unchanged; identical values or an empty patch are a true no-op, preserving an overdue run. Extra fields are ignored. This never starts a sync or changes additional custom schedules.

patch/api/v2/sync/schedule

Request

Base URL: https://fintable.io
URL: https://fintable.io/api/v2/sync/schedule
Auth: HTTP bearer

Query parameters

workspace_idstring

Optional Workspace ID (ws_...) from GET /workspaces. Omit to act on the calculated default Workspace (the oldest one the person owns, otherwise the oldest one they belong to; is_default in GET /workspaces); omission returns validation_failed (422) only when the person belongs to no Workspace. Always a query parameter — on POST/PATCH/DELETE too; a body field never selects a Workspace. Unknown and unauthorized Workspace IDs return the standard not_found error.

Request body

daily_sync_timestring

Local daily time, HH:mm. Cannot be null.

timezonestring

IANA timezone, such as America/New_York or UTC. Cannot be null.

Response

Updated schedule; no sync is started.

Example response

{
  "data": {
    "schedule": {
      "daily_sync_time": "08:37",
      "timezone": "America/New_York"
    }
  }
}

Changes

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