---
title: "Update Scheduled Task"
method: PATCH
path: "/api/agent-scheduled-tasks/{definition_id}"
tags: ["agent-scheduled-tasks"]
---

# Update Scheduled Task

`PATCH /api/agent-scheduled-tasks/{definition_id}`

Update a scheduled task definition's metadata.

This allows updating display_name, schedule_config, timezone, and email_results.
If schedule_config is changed, the next run will be rescheduled.

## Path parameters

- `definition_id` string, required

## Query parameters

- `user_id` string
- `org_id` string

## Request body

- RoutesAgentScheduledTasksUpdateScheduledTaskRequest — Request body for updating a scheduled task definition.
  - `display_name` string, nullable
  - `schedule_type` string, nullable
  - `schedule_config` object, nullable
  - `config` object, nullable
  - `timezone` string, nullable
  - `email_results` boolean, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

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