Create, edit, end, or delete a change freeze
manage_change_freezeCreate, schedule, and end change freeze windows, then approve or revoke scheduled changes that need to apply during a freeze.
Instructions
Manage change freeze windows. action=create makes a window: name + reason + environments (keys) or all_environments. Give starts_at and ends_at to schedule it; omit starts_at to start at once, and omit ends_at for an open-ended freeze (a scheduled window with starts_at needs ends_at). action=freeze_now starts at once and never takes starts_at; it may leave ends_at open until you end it. Pass project for a project window; omit it for an organization-wide one. scheduled_change_policy: Hold (default) keeps scheduled changes pending until the freeze ends, Fail fails them. action=update needs freeze_id and changes only the fields you pass (accepts ifMatch). action=end stops an active window now. action=delete removes an UPCOMING window. action=approve_scheduled_change (freeze_id + scheduled_change_id + reason) lets one pending scheduled change apply inside the freeze; revoke_approval withdraws it. Creating a window or approving a change needs the Business plan or above (below it, update can only rename, change the reason or shorten); ending, deleting and revoking work on any plan. All need an Admin token.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"action": "<action>"
},
"name": "manage_change_freeze"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Window name, e.g. "Black Friday code freeze" | |
| action | Yes | create and freeze_now need name + reason + environments or all_environments; update, end and delete need freeze_id; approve_scheduled_change needs freeze_id + scheduled_change_id + reason; revoke_approval needs freeze_id + scheduled_change_id | |
| reason | No | Why the freeze exists (shown to people it blocks); for approve_scheduled_change, why the change may proceed | |
| ends_at | No | ISO 8601 UTC end. On create: required when scheduling (with starts_at); omitting it with no starts_at makes an open-ended freeze. On update: omitting it leaves the end unchanged. | |
| ifMatch | No | etag from list_change_freezes with freeze_id. The write is refused with 412 if the resource changed since that read; re-read and re-apply. Omit to write unconditionally. | |
| project | No | Project key for a project window; omit for organization-wide | |
| freeze_id | No | Freeze id (see list_change_freezes) | |
| starts_at | No | ISO 8601 UTC start. create only: omit (or use freeze_now) to freeze immediately | |
| environments | No | Environment keys the window covers, e.g. ["production"] | |
| idempotency_key | No | Idempotency-Key (a UUID) for create, freeze_now, end and approve_scheduled_change | |
| all_environments | No | Cover every environment instead of listing them | |
| scheduled_change_id | No | Scheduled change id, for approve_scheduled_change and revoke_approval | |
| scheduled_change_policy | No | What happens to scheduled changes that come due inside the window (default Hold) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||