Agents

Installed and latest version of the provider's harness CLI in your persistent workspace, and whether an update is available.

Changed on
get/settings/ai-providers/{provider_id}/harness-update

Request

  • Base URL: /api (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /api/settings/ai-providers/{provider_id}/harness-update
  • Auth: HTTP bearer

Path parameters

provider_idstring required

AI provider ID

Query parameters

refreshboolean

Look inside the workspace again instead of returning the cached check.

Response

Harness version status

checked_atstring nullable

When the versions were last read from the workspace (RFC 3339).

detailstring nullable

Why the versions could not be determined, when they could not.

installed_versionstring nullable

Version reported by the CLI in the workspace, when it could be read.

latest_versionstring nullable

Latest version published for the CLI, when it could be looked up.

provider_idstring required
update_availableboolean required

True only when both versions are known and latest_version is newer.

updatingboolean required

An update is running right now.

Changes