---
title: "Updates (patches) an existing registry record."
method: PATCH
path: "/orgs/{orgId}/registries/{regId}"
tags: ["public", "Registry"]
---

# Updates (patches) an existing registry record.

`PATCH /orgs/{orgId}/registries/{regId}`

## Path parameters

- `orgId` string, required
- `regId` string, required

## Request body

- RegistryRequest — Humanitec can be used to manage registry credentials. The Registry object represents how to match credentials to a particular registry. Humanitec supports all Docker compatible registries as well as the custom authentication formats used by AWS Elastic Container Registry and Google Container Registry. It also supports the injection of a specific secret to be copied from an existing namespace in the cluster.
  - `creds` AccountCredsRequest — AccountCreds represents an account credentials (either, username- or token-based).
    - `expires` string, nullable — Account credentials expiration timestamp.
    - `password` string, required — Account password or token secret.
    - `username` string, required — Security account login or token.
  - `enable_ci` boolean — Indicates if registry secrets and credentials should be exposed to CI agents.
  - `id` string, required — Registry ID, unique within the Organization.
  - `registry` string, required — Registry name, usually in a "{domain}" or "{domain}/{project}" format.
  - `secrets` ClusterSecretsMapRequest — ClusterSecretsMap stores a list of Kuberenetes secret references for the target deployment clusters.
  - `type` string, required — Registry type, describes the registry authentication method, and defines the schema for the credentials. Supported values: - `public` - `basic` - `google_gcr` - `amazon_ecr` - `secret_ref`

## Response `200`

Updated record details.

- RegistryResponse — Humanitec can be used to manage registry credentials. The Registry object represents how to match credentials to a particular registry. Humanitec supports all Docker compatible registries as well as the custom authentication formats used by AWS Elastic Container Registry and Google Container Registry. It also supports the injection of a specific secret to be copied from an existing namespace in the cluster.
  - `created_at` string, nullable — The timestamp of when this record was created.
  - `created_by` string — The user who created this record.
  - `enable_ci` boolean, required — Indicates if registry secrets and credentials should be exposed to CI agents.
  - `id` string, required — Registry ID, unique within the Organization.
  - `registry` string, required — Registry name, usually in a "{domain}" or "{domain}/{project}" format.
  - `secrets` ClusterSecretsMapResponse — ClusterSecretsMap stores a list of Kuberenetes secret references for the target deployment clusters.
  - `type` string, required — Registry type, describes the registry authentication method, and defines the schema for the credentials. Supported values: - `public` - `basic` - `google_gcr` - `amazon_ecr` - `secret_ref`

## Other responses

- `400` — Request parameters or payload are incomplete or invalid.
- `403` — Built-in 'humanitec' registry can't be changed.
- `404` — Specified 'orgId' or 'regId' do not match any record.
- `409` — The record with the same name (prefix) already exists within the organization.

---

[API](https://skmtc.net/humanitec/apis/humanitec-api.md) · [All operations](https://skmtc.net/humanitec/apis/humanitec-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/humanitec/humanitec-api/revisions/e21ad140ec3c/schema)