---
title: "Update Metadata Field"
method: PATCH
path: "/datasets/{dataset_id}/metadata/{metadata_id}"
tags: ["Metadata"]
---

# Update Metadata Field

`PATCH /datasets/{dataset_id}/metadata/{metadata_id}`

Rename a custom metadata field.

## Path parameters

- `dataset_id` string, uuid, required
- `metadata_id` string, uuid, required

## Request body

- object
  - `name` string, required — New name for the field. Must be unique among the knowledge base's fields and at most 255 characters.

## Response `200`

Metadata field updated successfully.

- object
  - `id` string — Metadata field identifier.
  - `name` string — Metadata field name.
  - `type` string — Metadata field type.

## Other responses

- `400` — `invalid_param` : The metadata name already exists, exceeds 255 characters, or conflicts with a built-in field.
- `403` — - `forbidden` : Dataset api access is not enabled. - `forbidden` : Sorry, you have reached the knowledge base request rate limit of your subscription.
- `404` — `not_found` : Dataset not found.

---

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