Platform

Change one server's agent update policy

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.

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

Path parameters

agent_idstring required

Request body

update_channel'stable' | 'beta' | 'pinned'

pinned_versionstring nullable

Numeric X.Y.Z; required when channel is pinned, null otherwise.

Example request

{
  "maintenance_window_utc": {
    "start": "01:00",
    "end": "05:00"
  }
}

Response

Updated policy (same shape as the GET)

Changes

No recorded changes to this operation across all 1 revision of this API.