---
title: "Edit a scheduled agent"
method: PATCH
path: "/scheduled-agents/{id}"
tags: ["Scheduled agents"]
---

# Edit a scheduled agent

`PATCH /scheduled-agents/{id}`

## Response `200`

The updated scheduled agent.

- ScheduledAgent
  - `object` 'scheduled_agent', required
  - `id` string, uuid, required
  - `workspaceId` string, uuid, required
  - `slug` string, required
  - `name` string, required
  - `description` string, nullable, required
  - `prompt` string, required
  - `cron` string, required
  - `model` string, nullable, required
  - `enabled` boolean, required
  - `planBlocked` boolean, required — True when the org cannot currently run scheduled tasks (gated at dispatch).
  - `nextRunAt` string, date-time, nullable, required
  - `lastRunAt` string, date-time, nullable, required
  - `url` string, uri, required
  - `handoff` object — Present when planBlocked — points the caller at the upgrade flow.

---

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