---
title: "Creates an external registry with the specified parameters."
method: POST
path: "/external_registry"
tags: ["externalRegistries"]
---

# Creates an external registry with the specified parameters.

`POST /external_registry`

Required RBAC Policy: kots/externalregistry/create

## Request body

- object
  - `appIds` string[] — AppIds is a list of app IDs that can access this registry. If null or empty, registry is shared across all apps. (optional)
  - `authType` string — Auth type for the upstream registry (optional)
  - `copyPassword` boolean — CopyPassword flag to indicate if password should be copied from original registry (optional)
  - `endpoint` string, required — Endpoint of the upstream registry.
  - `originalSlug` string — OriginalSlug is used when duplicating a registry to copy passwords if they're unchanged (optional)
  - `password` string, required — Password for authentication with the upstream registry.
  - `provider` string — Provider of the upstream registry. (optional)
  - `skipValidation` boolean — SkipValidation just saves the values without checking if the registry is valid.
  - `slug` string — Slug (registry name) for the upstream registry. If not provided, the endpoint will be used as the slug. (optional)
  - `username` string, required — Username for authentication with the upstream registry.

## Response `201`

CreateExternalRegistryResponse represents an 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

---

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