---
title: "Check whether container scanning is enabled"
method: POST
path: "/api/v2/containerImages/settingsEnabled"
tags: ["Container Scanning"]
---

# Check whether container scanning is enabled

`POST /api/v2/containerImages/settingsEnabled`

## Request

- Base URL: `https://zeropath.com`
- URL: `https://zeropath.com/api/v2/containerImages/settingsEnabled`
- Auth: API key in header `X-ZeroPath-API-Token-Id` and API key in header `X-ZeroPath-API-Token-Secret`

Report whether the CONTAINER full-scan module is enabled for any repository the caller can access. Container scanning runs as a standalone phase (independent of source-code scans), so only full-scan settings are inspected. Powers the Containers tab gate.

## Request body

- ContainerImageSettingsEnabledRequest: Input for checking whether container scanning is enabled for any accessible repository.
  - `organizationId` string: Organization ID (optional).

## Response `200`

Setting state retrieved

- ContainerImageSettingsEnabledResponse: Whether the CONTAINER full-scan module is enabled for any repository the caller can see.
  - `enabled` boolean, required: True when at least one accessible repository has container scanning enabled.
  - `hasRepositories` boolean, required: False when the caller has no accessible repositories.

## Other responses

- `401`: Error Response

---

[API](https://skmtc.dev/zeropath/apis/zeropath-api.md) - [All operations](https://skmtc.dev/zeropath/apis/zeropath-api/llms.txt) - [OpenAPI document](https://skmtc.dev/zeropath/apis/zeropath-api/revisions/126e9c80ba0d?raw)