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

# Read one server's agent update policy

`GET /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`

Returns the update channel (stable, beta or pinned), pinned
version, maintenance window (UTC), the channel's available
version, end-of-life status against the channel minimum, whether
the installed agent supports update jobs (agent-upgrade-v1), and
the last agent update job with its heartbeat verification state.
Channels shape the offer only — nothing is updated by this read.

## Path parameters

- `agent_id` string, required

## Response `200`

Update policy

## Other responses

- `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)