---
title: "Upgrade agents to a specific version"
method: POST
path: "/upgrades/agents"
tags: ["Upgrades", "Agents"]
---

# Upgrade agents to a specific version

`POST /upgrades/agents`

## Request body

- PrivateUpgradesAgentsAction
  - `filters` StorageTableFilter[]
    - `field` string, required
    - `operator` '<' | '<=' | '>=' | '>' | '=' | '!=' | 'like' | 'not like' | 'in'
    - `value` object, required
  - `version` string, required

## Response `201`

agents upgrade requested succesful

- object
  - `data` object
    - `batch` string
    - `total` integer
  - `status` string

## Other responses

- `400` — invalid agents upgrade request
- `403` — upgrading agents not permitted
- `404` — agent binary file not found
- `500` — internal error on requesting agents to upgrade

---

[API](https://skmtc.net/vxcontrol/apis/soldr-swagger-api.md) · [All operations](https://skmtc.net/vxcontrol/apis/soldr-swagger-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/vxcontrol/soldr-swagger-api/versions/ac519ec936b3/schema)