---
title: "Tests scanner registration settings"
method: POST
path: "/scanners/ping"
tags: ["scanner"]
---

# Tests scanner registration settings

`POST /scanners/ping`

Pings scanner adapter to test endpoint URL and authorization settings.

## Headers

- `X-Request-Id` string

## Request body

- ScannerRegistrationSettings
  - `name` string, required — The name of this registration
  - `url` string, uri, required — A base URL of the scanner adapter.
  - `auth` string — Specify what authentication approach is adopted for the HTTP communications. Supported types Basic", "Bearer" and api key header "X-ScannerAdapter-API-Key"
  - `access_credential` string — An optional value of the HTTP Authorization header sent with each request to the Scanner Adapter API.

## Response `200`

Success

## Other responses

- `400` — Bad request
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal server error

---

[API](https://skmtc.dev/cerit/apis/harbor-api.md) · [All operations](https://skmtc.dev/cerit/apis/harbor-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/cerit/harbor-api/revisions/62d78801f8df/schema)