---
title: "Changes to Create Run Schedule"
method: POST
path: "/agents/{agent_id}/schedules"
---

# Changes to Create Run Schedule

`POST /agents/{agent_id}/schedules`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 2 of 58 revisions.

- **2026-07-28** `8f725ddc153e`: 1 info
- **2026-07-10** `fbecbdbd7dc5`: 5 breaking, 5 warning, 21 info

## Changes

- **2026-07-28** `8f725ddc153e`: 1 info
  - added the optional property `live_data_available` to the response with the `200` status
- **2026-07-10** `fbecbdbd7dc5`: 5 breaking, 5 warning, 21 info
  - added the new required request property `initial_input`
  - the response property `state` became optional for the status `200`
  - removed the required property `action` from the response with the `200` status
  - removed the required property `schedule_id` from the response with the `200` status
  - removed the required property `spec` from the response with the `200` status
  - removed the request property `execution_timeout_seconds`
  - removed the request property `task_queue`
  - removed the request property `workflow_name`
  - removed the request property `workflow_params`
  - removed the optional property `num_actions_missed` from the response with the `200` status
  - api operation id `create_schedule_agents__agent_id__schedules_post` removed and replaced with `create_run_schedule_agents__agent_id__schedules_post`
  - added the new optional request property `description`
  - added the new optional request property `task_metadata`
  - added the new optional request property `task_params`
  - added the new optional request property `timezone`
  - added the optional property `creator_principal` to the response with the `200` status
  - added the optional property `cron_expression` to the response with the `200` status
  - added the optional property `description` to the response with the `200` status
  - added the optional property `end_at` to the response with the `200` status
  - added the optional property `interval_seconds` to the response with the `200` status
  - added the optional property `paused` to the response with the `200` status
  - added the optional property `skipped_action_times` to the response with the `200` status
  - added the optional property `start_at` to the response with the `200` status
  - added the optional property `task_metadata` to the response with the `200` status
  - added the optional property `task_params` to the response with the `200` status
  - added the optional property `timezone` to the response with the `200` status
  - added the optional property `updated_at` to the response with the `200` status
  - the `state` response's property default value `ACTIVE` was added for the status `200`
  - added the required property `id` to the response with the `200` status
  - added the required property `initial_input` to the response with the `200` status
  - added the required property `initial_input_method` to the response with the `200` status

---

[Operation](https://skmtc.dev/scaleapi/apis/agentex-api/docs/agents/:agent_id/schedules/post.md) - [API](https://skmtc.dev/scaleapi/apis/agentex-api.md) - [Page](https://skmtc.dev/scaleapi/apis/agentex-api/changes/agents/:agent_id/schedules/post)