---
title: "Changes to Create a schedule for an agent"
method: POST
path: "/v1/agents/{workflow_permanent_id}/schedules"
---

# Changes to Create a schedule for an agent

`POST /v1/agents/{workflow_permanent_id}/schedules`

> Every recorded change to this endpoint, newest first.

## Timeline

Changed in 4 of 101 revisions.

- **2026-09-27** `4cb8e84f79f2` — 4 info
- **2026-09-25** `7989ab3e2c03` — 2 breaking, 6 info
- **2026-07-12** `3c39ee1fef00` — 1 info
- **2026-06-08** `3a3616091b66` — 1 info

## Changes

- **2026-09-27** `4cb8e84f79f2` — 4 info
  - added the new optional request property `run_at`
  - added the optional property `schedule/dispatch_status` to the response with the `200` status
  - added the optional property `schedule/run_at` to the response with the `200` status
  - added the optional property `schedule/workflow_run_id` to the response with the `200` status
- **2026-09-25** `7989ab3e2c03` — 2 breaking, 6 info
  - the response property `schedule/cron_expression` became optional for the status `200`
  - response property `schedule/cron_expression` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the new optional request property `first_fire_at`
  - added the new optional request property `interval_seconds`
  - the request property `cron_expression` became optional
  - request property `cron_expression` list-of-types was widened by adding types `null` to media type `application/json`
  - added the optional property `schedule/first_fire_at` to the response with the `200` status
  - added the optional property `schedule/interval_seconds` to the response with the `200` status
- **2026-07-12** `3c39ee1fef00` — 1 info
  - request property `enabled` list-of-types was widened by adding types `null` to media type `application/json`
- **2026-06-08** `3a3616091b66` — 1 info
  - endpoint added

---

[Operation](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/docs/v1/agents/:workflow_permanent_id/schedules/post.md) · [API](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2.md) · [Page](https://skmtc.dev/skyvern-ai/apis/skyvern-api-2/changes/v1/agents/:workflow_permanent_id/schedules/post)