---
title: "Update execution schedule"
method: PATCH
path: "/api/schedules/{schedule_id}"
tags: ["v1", "schedules"]
---

# Update execution schedule

`PATCH /api/schedules/{schedule_id}`

## Request

- The document declares no server URL.
- Auth: HTTP bearer

Change an agent schedule's name, timing or inputs. Only the schedule's
owner can edit it; anyone else gets the same 404 as a missing schedule.

## Path parameters

- `schedule_id` string, required: ID of the schedule to update

## Request body

- ScheduleUpdateRequest: Fields to change on an existing schedule; omitted fields keep their value.
  - `name` string, nullable
  - `cron` string, nullable
  - `inputs` object, nullable
  - `credentials` object, nullable
  - `timezone` string, nullable: Timezone to evaluate the cron in (e.g., 'America/New_York'). If not provided, the schedule keeps its current timezone.

## Response `200`

Successful Response

- GraphExecutionJobInfo
  - `kind` 'graph'
  - `schedule_id` string, nullable
  - `user_id` string, required
  - `graph_id` string, required
  - `graph_version` integer, required
  - `agent_name` string, nullable
  - `cron` string, required
  - `input_data` object, required
  - `input_credentials` object
  - `organization_id` string
  - `team_id` string, nullable
  - `expert_id` string, nullable
  - `id` string, required
  - `name` string, required
  - `next_run_time` string, required
  - `timezone` string: Timezone used for scheduling

## Other responses

- `401`: Authentication required
- `422`: Validation Error

## Changes

- **2026-10-11** `4acab2dc1fbf`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/changes/api/schedules/:schedule_id/patch.md)

---

[API](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server.md) - [All operations](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/llms.txt) - [OpenAPI document](https://skmtc.dev/significant-gravitas/apis/autogpt-agent-server/revisions/c508818c16ad?raw)