---
title: "Update registry configuration"
method: PUT
path: "/api/v1beta/registry/{name}"
tags: ["registry"]
---

# Update registry configuration

`PUT /api/v1beta/registry/{name}`

Update registry URL or local path for the default registry

## Path parameters

- `name` string, required

## Request body

- union
  - object
  - V1UpdateRegistryRequest — Request containing registry configuration updates
    - `allow_private_ip` boolean — Allow private IP addresses for registry URL or API URL
    - `api_url` string — MCP Registry API URL
    - `local_path` string — Local registry file path
    - `url` string — Registry URL (for remote registries)

## Response `200`

OK

- V1UpdateRegistryResponse — Response containing update result
  - `message` string — Status message
  - `type` string — Registry type after update

## Other responses

- `400` — Bad Request
- `404` — Not Found

## Changes

- **2026-01-29** `ff6ce8dd8f3a` — 1 breaking, 5 info
  - removed `#/components/schemas/pkg_api_v1.UpdateRegistryRequest` from the request body `oneOf` list
  - added `#/components/schemas/v1.UpdateRegistryRequest` to the request body `oneOf` list
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `502`
  - …2 more

[Change history](https://skmtc.dev/stacklok/apis/toolhive-api/changes/api/v1beta/registry/:name/put.md)

---

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