---
title: "Retrieve policy modules list ready to update by system module name and version"
method: GET
path: "/modules/{module_name}/versions/{version}/updates"
tags: ["Modules"]
---

# Retrieve policy modules list ready to update by system module name and version

`GET /modules/{module_name}/versions/{version}/updates`

## Path parameters

- `module_name` string, required
- `version` string, required

## Response `200`

policy modules list received successful

- object
  - `data` object
    - `modules` ModelsModuleA[]
      - `action_config_schema` object, required
      - `changelog` ModelsChangelog, required
      - `config_schema` object, required
      - `current_action_config` ModelsActionConfig, required
      - `current_config` ModelsModuleConfig, required
      - `current_event_config` ModelsEventConfig, required
      - `default_action_config` ModelsActionConfig, required
      - `default_config` ModelsModuleConfig, required
      - `default_event_config` ModelsEventConfig, required
      - `deleted_at` string
      - `dynamic_dependencies` ModelsDependencyItem[], required
        - `min_agent_version` string
        - `min_module_version` string
        - `module_name` string
        - `type` 'to_receive_data' | 'to_send_data' | 'to_make_action' | 'agent_version', required
      - `event_config_schema` object, required
      - `fields_schema` object, required
      - `files_checksums` ModelsFilesChecksumsMap
      - `id` integer
      - `info` ModelsModuleInfo, required
        - `actions` string[], required
        - `events` string[], required
        - `fields` string[], required
        - `name` string, required
        - `os` ModelsModuleInfoOS, required
        - `system` boolean
        - `tags` string[], required
        - `template` 'generic' | 'empty' | 'collector' | 'detector' | 'responder' | 'custom', required
        - `version` ModelsSemVersion, required
          - `major` integer
          - `minor` integer
          - `patch` integer
      - `join_date` string
      - `last_module_update` string, required
      - `last_update` string
      - `locale` ModelsLocale, required
        - `action_config` object, required
        - `actions` object, required
        - `config` object, required
        - `event_config` object, required
        - `events` object, required
        - `fields` object, required
        - `module` ModelsModuleLocaleDesc, required
        - `secure_config` object
        - `tags` object, required
      - `policy_id` integer
      - `secure_config_schema` object
      - `secure_current_config` ModelsModuleSecureConfig
      - `secure_default_config` ModelsModuleSecureConfig
      - `state` 'draft' | 'release'
      - `static_dependencies` ModelsDependencyItem[], required
        - `min_agent_version` string
        - `min_module_version` string
        - `module_name` string
        - `type` 'to_receive_data' | 'to_send_data' | 'to_make_action' | 'agent_version', required
      - `status` 'joined' | 'inactive', required
    - `policies` ModelsPolicy[]
      - `created_date` string
      - `deleted_at` string
      - `hash` string, required
      - `id` integer
      - `info` ModelsPolicyInfo, required
        - `name` ModelsPolicyItemLocale, required
          - `en` string, required
          - `ru` string, required
        - `system` boolean
        - `tags` string[], required
      - `updated_at` string
  - `status` string

## Other responses

- `403` — getting policy modules list not permitted
- `404` — system module not found
- `500` — internal error on getting policy modules list to update

---

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