---
title: "Updates an external registry with the specified parameters."
method: PUT
path: "/external_registry/{slug}"
tags: ["externalRegistries"]
---

# Updates an external registry with the specified parameters.

`PUT /external_registry/{slug}`

Required RBAC Policy: kots/externalregistry/update

## Path parameters

- `slug` string, required

## Request body

- object
  - `appIds` string[] — AppIds is a list of app IDs that can access this registry. If null/omitted, existing appIds are preserved If empty array [], registry becomes shared across all apps If contains values, registry is scoped to those apps (optional)
  - `authType` string — Authentication type for the registry (e.g., "password", "token"). (optional)
  - `endpoint` string — Endpoint of the external registry. (optional)
  - `password` string — Password for authentication with the upstream registry. (optional)
  - `provider` string — Provider of the external registry (e.g., "dockerhub", "gcr", "ecr", etc.). (optional)
  - `username` string — Username for authentication with the upstream registry. (optional)

## Response `200`

UpdateExternalRegistryResponse represents an updated external registry.

- object
  - `external_registry` ExternalRegistry
    - `appIds` string[]
    - `authType` string
    - `createdAt` string, date-time
    - `endpoint` string
    - `isReplicated` boolean
    - `provider` string
    - `slug` string
    - `teamId` string
    - `updatedAt` string, date-time
    - `username` string

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