# Dify Metadata API

**Canonical:** https://apis.io/apis/dify/dify-metadata-api/  
**Provider:** Dify — https://apis.io/providers/dify/  
**Base URL:** https://api.dify.ai/v1  
**Documentation:** https://docs.dify.ai/en/api-reference/knowledge-bases/list-knowledge-bases

Dify Metadata API is one of 19 APIs that [Dify](https://apis.io/providers/dify/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Metadata and Knowledge Management. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

Operations for managing knowledge base metadata fields and document metadata values. 7 operation(s) from the Dify Service API.

## Operations (7)

| Method | Path | Summary |
|---|---|---|
| POST | `/datasets/{dataset_id}/metadata` | Create Metadata Field |
| GET | `/datasets/{dataset_id}/metadata` | List Metadata Fields |
| PATCH | `/datasets/{dataset_id}/metadata/{metadata_id}` | Update Metadata Field |
| DELETE | `/datasets/{dataset_id}/metadata/{metadata_id}` | Delete Metadata Field |
| GET | `/datasets/{dataset_id}/metadata/built-in` | Get Built-in Metadata Fields |
| POST | `/datasets/{dataset_id}/metadata/built-in/{action}` | Update Built-in Metadata Field |
| POST | `/datasets/{dataset_id}/documents/metadata` | Update Document Metadata in Batch |

## Machine-readable artifacts (2)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/dify/refs/heads/main/openapi/dify-metadata-api-openapi.yml
- **APIReference** — https://docs.dify.ai/en/api-reference/knowledge-bases/list-knowledge-bases

## Other Dify APIs (12)

- [Dify](https://apis.io/apis/dify/dify/)
- [Dify Chat Messages API](https://apis.io/apis/dify/dify-chat-api/)
- [Dify Completion Messages API](https://apis.io/apis/dify/dify-completion-api/)
- [Dify Conversations API](https://apis.io/apis/dify/dify-conversations-api/)
- [Dify Knowledge Bases API](https://apis.io/apis/dify/dify-datasets-api/)
- [Dify Files API](https://apis.io/apis/dify/dify-files-api/)
- [Dify Workflow Runs API](https://apis.io/apis/dify/dify-workflows-api/)
- [Dify Applications API](https://apis.io/apis/dify/dify-applications-api/)
- [Dify Annotations API](https://apis.io/apis/dify/dify-annotations-api/)
- [Dify Audio API](https://apis.io/apis/dify/dify-audio-api/)
- [Dify Feedback API](https://apis.io/apis/dify/dify-feedback-api/)
- [Dify End Users API](https://apis.io/apis/dify/dify-end-users-api/)

## Tags

Metadata, Knowledge Management

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/dify/dify-metadata-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/dify/.