Metadata
Update Metadata Field
Rename a custom metadata field.
PATCH
Update Metadata Field
Authorizations
Every request authenticates with an API key: Authorization: Bearer {API_KEY}. App endpoints take an app API key; knowledge endpoints take a knowledge base API key (Get Started).
Keep keys server-side; never embed them in client code. Requests with a missing or invalid key fail with HTTP 401 (unauthorized).
Path Parameters
Knowledge base ID, from List Knowledge Bases. For a scoped key, copy the ID from the Dify URL.
ID of the metadata field to rename. See List Metadata Fields.
Body
application/json
New name for the field. Must be unique among the knowledge base's fields and at most 255 characters.
Last modified on September 22, 2026