---
title: "Change one server's agent update policy"
method: PUT
path: "/platform/servers/{agent_id}/update-policy"
tags: ["Platform"]
---

# Change one server's agent update policy

`PUT /platform/servers/{agent_id}/update-policy`

## Request

- Base URL: `https://api.imprezahost.com/v1`
- URL: `https://api.imprezahost.com/v1/platform/servers/{agent_id}/update-policy`
- Auth: API key in header `X-API-Key` and API key in header `X-API-Secret`

Sets the update channel, the pinned version (required with
channel `pinned`) and/or the daily maintenance window in UTC.
The policy gates customer-requested updates and shapes what the
portal offers; it never updates anything by itself. Servers
pinned to a version never receive update offers.

## Path parameters

- `agent_id` string, required

## Request body

- object
  - `update_channel` 'stable' | 'beta' | 'pinned'
  - `pinned_version` string, nullable: Numeric X.Y.Z; required when channel is pinned, null otherwise.
  - `maintenance_window_utc` object, nullable: Daily UTC window {start, end} as HH:MM, or null for any time.
    - `start` string, required
    - `end` string, required

## Response `200`

Updated policy (same shape as the GET)

## Other responses

- `400`: Validation failed on the request body or query parameters
- `401`: Invalid or missing API credentials
- `404`: Resource not found

---

[API](https://skmtc.dev/imprezahost/apis/impreza-host-public-api.md) · [All operations](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/imprezahost/apis/impreza-host-public-api/revisions/db86511f604f?raw)