---
title: "Update a scanner registration"
method: PUT
path: "/scanners/{registration_id}"
tags: ["scanner"]
---

# Update a scanner registration

`PUT /scanners/{registration_id}`

Updates the specified scanner registration.

If `access_credential` is omitted or empty in the request body and the registration still uses
an authentication type that requires a credential (Basic, Bearer, or APIKey), the existing stored
credential is left unchanged. Send a non-empty `access_credential` to set or rotate the secret.

## Path parameters

- `registration_id` string, required

## Headers

- `X-Request-Id` string

## Request body

- ScannerRegistrationReq
  - `name` string, required — The name of this registration
  - `description` string — An optional description 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. When updating a registration (PUT `/scanners/{registration_id}`), if this field is omitted or empty and `auth` is still one of Basic, Bearer, or APIKey, the previously stored credential is kept unchanged. Provide a non-empty value to set or rotate the credential. Clearing `auth` removes the need for a credential; in that case an empty `access_credential` does not restore the old secret.
  - `skip_certVerify` boolean — Indicate if skip the certificate verification when sending HTTP requests
  - `use_internal_addr` boolean — Indicate whether use internal registry addr for the scanner to pull content or not
  - `disabled` boolean — Indicate whether the registration is enabled or not

## Response `200`

Success

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not found
- `500` — Internal server error

---

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