---
title: "Update"
method: PUT
path: "/metadata-schemas/v1/{id}/{version}"
tags: ["v1"]
---

# Update

`PUT /metadata-schemas/v1/{id}/{version}`

Updates a custom metadata schema. Updates are additive only: new fields may be added but existing fields may not be removed or have their type changed, and ENUM field value lists may be extended but not shrunk. The path must contain the most recent version to prevent races.

## Path parameters

- `id` CommonMetadataSchemaId, required — unresolved $ref
- `version` string, required

## Headers

- `Authorization` string, required

## Request body

- V1MutableMetadataSchema — unresolved $ref

## Response `200`

Response with status 200

- V1MetadataSchema — unresolved $ref

## Changes

- **2026-08-26** `293f25b8a5c7` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/joincandidhealth/apis/api-reference/changes/metadata-schemas/v1/:id/:version/put.md)

---

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