---
title: "Compare an installed harness version with its known package source"
method: GET
path: "/api/v1/agents/{agent}/update-advisory"
tags: ["agents"]
---

# Compare an installed harness version with its known package source

`GET /api/v1/agents/{agent}/update-advisory`

## Request

- Base URL: `http://127.0.0.1:3001`
- URL: `http://127.0.0.1:3001/api/v1/agents/{agent}/update-advisory`
- Auth: none declared

## Path parameters

- `agent` string, required: Agent adapter identifier.

## Query parameters

- `refresh` boolean: Re-probe the installed binary, ownership and latest release instead of reusing cached advisory evidence.

## Response `200`

OK

- AgentUpdateAdvisory
  - `agentId` string, required
  - `binaryPath` string
  - `checkedAt` string, date-time, required
  - `currentVersion` string
  - `inUse` AgentUpdateInUse
    - `level` 'safe' | 'warn' | 'blocked' | 'idle', required: Whether an update can run while they do: safe keeps the running release, warn may disturb it, blocked requires them to end, idle waits until they are idle and restarts them around the update.
    - `liveSessions` integer, required: Sessions running this harness, directly or through their reviewer.
    - `sessionIds` string[]: Sessions that run this harness or own a reviewer that does.
  - `latestVersion` string
  - `maintenanceMethod` string
  - `reason` 'ownership_unconfirmed' | 'unsupported_source' | 'version_unparseable' | 'channel_unconfirmed' | 'lookup_failed' | 'disabled' | 'build_unordered'
  - `source` string
  - `status` 'unknown' | 'current' | 'behind_latest' | 'ahead_of_latest', required

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error
- `501`: Not Implemented

## Changes

- **2026-10-21** `8f160e6183cd`: 3 info
  - removed the `agent_switch_saga` enum value from the `reporting_owner` response property for the response status `400`
  - removed the `agent_switch_saga` enum value from the `reporting_owner` response property for the response status `500`
  - removed the `agent_switch_saga` enum value from the `reporting_owner` response property for the response status `501`
- **2026-10-19** `f6d1ae4671f5`: 1 info
  - added the optional property `inUse` to the response with the `200` status
- **2026-10-15** `cdbb87fa6b57`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/changes/api/v1/agents/:agent/update-advisory/get.md)

---

[API](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon.md) - [All operations](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/llms.txt) - [OpenAPI document](https://skmtc.dev/composiohq/apis/agent-orchestrator-http-daemon/revisions/61d7efd08578?raw)