# Dify Documents API

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

Dify Documents 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 Documents and Knowledge Management. The published artifact set on APIs.io includes an OpenAPI specification and an API reference.

Operations for creating, updating, and managing documents within a knowledge base. 12 operation(s) from the Dify Service API.

## Operations (12)

| Method | Path | Summary |
|---|---|---|
| POST | `/datasets/{dataset_id}/document/create-by-text` | Create Document by Text |
| POST | `/datasets/{dataset_id}/document/create-by-file` | Create Document by File |
| GET | `/datasets/{dataset_id}/documents` | List Documents |
| GET | `/datasets/{dataset_id}/documents/{document_id}` | Get Document |
| DELETE | `/datasets/{dataset_id}/documents/{document_id}` | Delete Document |
| PATCH | `/datasets/{dataset_id}/documents/{document_id}` | Update Document |
| GET | `/datasets/{dataset_id}/documents/{document_id}/download` | Download Document |
| GET | `/datasets/{dataset_id}/documents/{batch}/indexing-status` | Get Document Indexing Status |
| POST | `/datasets/{dataset_id}/documents/{document_id}/update-by-text` | Update Document by Text |
| POST | `/datasets/{dataset_id}/documents/{document_id}/update-by-file` | Update Document by File |
| POST | `/datasets/{dataset_id}/documents/download-zip` | Download Documents as ZIP |
| PATCH | `/datasets/{dataset_id}/documents/status/{action}` | Update Document Status in Batch |

## Machine-readable artifacts (2)

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

## 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

Documents, Knowledge Management

---

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