---
title: "Test external registry for a team."
method: PUT
path: "/external_registry/test"
tags: ["externalRegistries"]
---

# Test external registry for a team.

`PUT /external_registry/test`

Required RBAC Policy: kots/externalregistry/test

## Request body

- object
  - `copyPassword` boolean — Whether to copy password from original registry when testing
  - `endpoint` string, required — Endpoint of the external registry.
  - `image` string, required — Image to test pulling.
  - `originalSlug` string — Original registry slug to copy password from when testing during duplication
  - `password` string — Password to use, provide only when testing before saving
  - `slug` string — Slug of the external registry. Will default to the endpoint if not provided.
  - `username` string — Username to use, provide only when testing before saving

## Response `200`

TestExternalRegistriesResponse contains the JSON external registries test

- object
  - `error` string
  - `status` integer

## Other responses

- `400` — Returned on bad input
- `401` — Return if the caller is not authorized
- `403` — Returned if the caller does not have the needed permission
- `404` — Returned on resource not found

---

[API](https://skmtc.net/replicated/apis/vendor-api-v3-2.md) · [All operations](https://skmtc.net/replicated/apis/vendor-api-v3-2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/replicated/vendor-api-v3-2/versions/6fcf9e54aba4/schema)