# update\_schedule

Replace every field of a schedule.

writes · idempotent · MCP tool · [Schedule](https://komrad.dev/latest/api/schedule.md)

Fields left empty are written empty.

## Calling it

```bash
curl -X POST http://127.0.0.1:8787/komrad.schedule.v1.ScheduleService/UpdateSchedule \
  -H 'Content-Type: application/json' \
  -d '{
  "id": "<id>",
  "name": "<name>",
  "cron": "<cron>",
  "prompt": "<prompt>",
  "workflow_id": "<workflow_id>"
}'
```

```bash
komrad rpc update-schedule \
  --id '<uuid>' \
  --name '<string>' \
  --cron '<string>' \
  --prompt '<string>' \
  --workflow-id '<uuid>'
```

```json
{
  "name": "update_schedule",
  "arguments": {
    "id": "<id>",
    "name": "<name>",
    "cron": "<cron>",
    "prompt": "<prompt>",
    "workflow_id": "<workflow_id>"
  }
}
```

Offered by the komrad MCP server to orchestrator agents.

## Request

### UpdateScheduleRequest

| Field | Type | Description |
| --- | --- | --- |
| [`id`](https://komrad.dev/latest/api/schedule/update-schedule.md#komrad-schedule-v1-UpdateScheduleRequest-id) | uuid\* | The schedule to update, by id. |
| [`name`](https://komrad.dev/latest/api/schedule/update-schedule.md#komrad-schedule-v1-UpdateScheduleRequest-name) | string\* at most 200 characters must not contain control characters | The schedule's name. |
| [`cron`](https://komrad.dev/latest/api/schedule/update-schedule.md#komrad-schedule-v1-UpdateScheduleRequest-cron) | string\* must be five whitespace-separated fields, such as '0 9 \* \* 1-5' | The schedule's cron expression. |
| [`timezone`](https://komrad.dev/latest/api/schedule/update-schedule.md#komrad-schedule-v1-UpdateScheduleRequest-timezone) | string at most 100 characters | The timezone to read the cron expression in. Empty uses the machine's timezone. |
| [`enabled`](https://komrad.dev/latest/api/schedule/update-schedule.md#komrad-schedule-v1-UpdateScheduleRequest-enabled) | bool | Whether the schedule is enabled. |
| [`prompt`](https://komrad.dev/latest/api/schedule/update-schedule.md#komrad-schedule-v1-UpdateScheduleRequest-prompt) | string\* at most 50000 characters | The prompt for later runs. Agents already launched keep theirs. |
| [one of](https://komrad.dev/latest/api/schedule/update-schedule.md#komrad-schedule-v1-UpdateScheduleRequest-target)\* |  | What later runs do. |
| [`workflow_id`](https://komrad.dev/latest/api/schedule/update-schedule.md#komrad-schedule-v1-UpdateScheduleRequest-workflow_id) | uuid | The workflow to create a task in, by id. |
| [`orchestrator_agent_id`](https://komrad.dev/latest/api/schedule/update-schedule.md#komrad-schedule-v1-UpdateScheduleRequest-orchestrator_agent_id) | uuid | The orchestrator to mail the prompt to, by id. |

## Response

### Empty

No fields.
