---
title: "Update Schedule Endpoint"
method: PUT
path: "/studio/schedules/{schedule_id}"
tags: ["AI_STUDIO", "SCHEDULES"]
---

# Update Schedule Endpoint

`PUT /studio/schedules/{schedule_id}`

Update a schedule.

## Path parameters

- `schedule_id` string, uuid, required

## Request body

- AppSchemasAiPlaygroundSchedulesScheduleUpdateRequest — Request to update an existing schedule. ``slack_webhook_id``: - ``None`` (omitted) → leave webhook unchanged - ``0`` → clear the current webhook - any positive integer → set the webhook to that notification id
  - `name` string, nullable
  - `content_scope` 'first_query' | 'last_answer' | 'full_chat' — What content to include in the scheduled report.
  - `frequency` 'daily' | 'weekly' | 'monthly' | 'custom' — Predefined schedule frequencies.
  - `custom_cron` string, nullable
  - `hour` integer, nullable
  - `day_of_week` integer, nullable — Day of week for weekly frequency (0=Sunday … 6=Saturday). Only meaningful when the patched frequency is 'weekly'. When the patched frequency stays/becomes 'weekly' and this field is omitted, the existing weekday is preserved.
  - `day_of_month` integer, nullable — Day of month for monthly frequency (1-31). Only meaningful when the patched frequency is 'monthly'.
  - `emails` string[], nullable
  - `slack_webhook_id` integer, nullable
  - `enabled` boolean, nullable

## Response `200`

Successful Response

- AppSchemasAiPlaygroundSchedulesScheduleResponse — Response containing schedule details.
  - `id` string, uuid, required
  - `name` string, required
  - `session_id` string, required
  - `content_scope` 'first_query' | 'last_answer' | 'full_chat', required — What content to include in the scheduled report.
  - `cron_expr` string, required
  - `destination_type` 'email' | 'slack' | 'multi', required — How to deliver the scheduled report. Derived from `destination_config` at save time — `MULTI` means both emails and a Slack webhook are configured on the same schedule.
  - `emails` string[], required
  - `slack_webhook_id` integer, nullable
  - `enabled` boolean, required
  - `last_run` string, date-time, nullable, required
  - `next_run` string, date-time, nullable, required
  - `created_by` integer, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `day_of_week` integer, nullable — Cron weekday (0=Sunday … 6=Saturday) when frequency is weekly
  - `day_of_month` integer, nullable — Cron day-of-month (1-31) when frequency is monthly

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/myaltimate/apis/fastapi.md) · [All operations](https://skmtc.net/myaltimate/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/myaltimate/fastapi/versions/aab3fe5c9f05/schema)