---
title: "Retrieve last agent upgrade information"
method: GET
path: "/upgrades/agents/{hash}/last"
tags: ["Upgrades", "Agents"]
---

# Retrieve last agent upgrade information

`GET /upgrades/agents/{hash}/last`

## Path parameters

- `hash` string, required

## Response `200`

last agent upgrade information received successful

- object
  - `data` object
    - `details` PrivateUpgradeAgentDetails
      - `agent` ModelsAgent
        - `auth_status` 'authorized' | 'unauthorized' | 'blocked', required
        - `connected_date` string
        - `created_date` string
        - `deleted_at` string
        - `description` string, required
        - `group_id` integer
        - `hash` string, required
        - `id` integer
        - `info` ModelsAgentInfo, required
          - `net` ModelsAgentNet, required
            - `hostname` string, required
            - `ips` string[], required
          - `os` ModelsAgentOS, required
            - `arch` '386' | 'amd64', required
            - `name` string, required
            - `type` 'windows' | 'linux' | 'darwin', required
          - `tags` string[], required
          - `users` ModelsAgentUser[], required
            - `groups` string[], required
            - `name` string, required
        - `ip` string, required
        - `status` 'connected' | 'disconnected', required
        - `updated_at` string
        - `version` string, required
      - `group` ModelsGroup
        - `created_date` string
        - `deleted_at` string
        - `hash` string, required
        - `id` integer
        - `info` ModelsGroupInfo, required
          - `name` ModelsGroupItemLocale, required
            - `en` string, required
            - `ru` string, required
          - `system` boolean
          - `tags` string[], required
        - `updated_at` string
    - `task` ModelsAgentUpgradeTask
      - `agent_id` integer
      - `batch` string, required
      - `created` string
      - `id` integer
      - `last_update` string
      - `reason` string
      - `status` 'new' | 'running' | 'ready' | 'failed', required
      - `version` string, required
  - `status` string

## Other responses

- `400` — invalid query request data
- `403` — getting last agent upgrade information not permitted
- `404` — agent or group or task not found
- `500` — internal error on getting last agent upgrade information

---

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