Dify

Dify is an open-source platform for building AI applications, combining Backend-as-a-Service and LLMOps to streamline the development of generative AI solutions for developers and non-technical innovators alike. Teams build agentic workflows, chatflows, agents and RAG knowledge pipelines on a visual canvas, then publish each one as a web app, an embeddable widget, a REST API or an MCP server. Dify is operated by Langgenius, Inc. and ships as Dify Cloud, a self-hosted Community Edition and a commercial Enterprise edition.

Dify publishes 18 API contracts indexed on the APIs.io network, including Conversations API, Files API, Applications API, and 15 more. Tagged areas include Artificial Intelligence, LLMOps, Backend-as-a-Service, Agents, and Workflows.

The Dify catalog on APIs.io includes 1 event-driven AsyncAPI specification and 1 Spectral governance ruleset.

Dify’s developer surface includes authentication, changelog, CLI, sandbox, documentation, API reference, getting-started guide, and 44 more developer resources.

🌐 Visit website 📡 Profile data on GitHub

78.4/100 exemplar ▬ flat Agent 41/100 agent ready Front door AI 6/6 dominant Heartbeat 94/100 alive Full breakdown ↓
scored 2026-11-06 · rubric v0.27.0 · Show this score on your site →

AccessFreemiumSelf serve⚡ Free to try

2 published contracts 1 MCP Servers 4 Agent Skills

Artificial Intelligence LLMOps Backend-as-a-Service Agents Workflows Knowledge Management RAG MCP Low-Code Open Source A2A

What this lets a business do 1

Business capabilities this provider's published APIs can perform, derived from its own contracts. Browse all capabilities →

AI Model Services

AE-110

DocumentsKnowledge BasesKnowledge Pipeline

POST /datasets POST /datasets/{dataset_id}/retrieve POST /datasets/{dataset_id}/document/create-by-text GET /datasets/{dataset_id}/documents

What people ask Dify 18

The questions people put to an LLM, and the jobs they hand an agent, that Dify's APIs answer — each one linked to the operation that does it. Generated by API Evangelist

Dify Documents API Add a document to a knowledge base from raw text “How do I add pasted text as a new document in my Dify knowledge base?” Add a document to a knowledge base from a file “Can I upload a PDF or DOCX straight into a knowledge base as a new document?” List the documents in a knowledge base “Which documents are in my knowledge base?” Get details of a single knowledge base document “What are the details and metadata of one document in my knowledge base?”

Dify Chunks API Add new chunks to a document “Can I manually add my own chunks of text to an existing document?” List the chunks in a document “How do I see how a knowledge base document was split into chunks?” Get the full details of one chunk “What is the full content and metadata of a single chunk?” Edit a chunk and re-index it “Can I fix the text of a parent chunk that was split badly?”

Dify Knowledge Tags API Create a knowledge base tag “How do I create a new tag for grouping knowledge bases?” List all knowledge base tags “Which tags exist for organizing knowledge bases in my workspace?” Rename a knowledge base tag “Can I rename a knowledge tag without re-tagging every knowledge base?” Delete a knowledge base tag “Are tagged knowledge bases deleted when I delete the tag itself?”

Dify Metadata API Create a custom metadata field “How do I add a custom metadata field like author or date to my documents?” List a knowledge base's metadata fields “Which metadata fields, custom and built-in, does my knowledge base have?” Rename a custom metadata field “Can I rename a custom metadata field without losing its values?” Delete a custom metadata field “Do documents lose their values when I delete a custom metadata field?”

Dify Workflow Runs API Get a workflow run's status and outputs “What were the inputs, outputs and status of a specific workflow run?” List past workflow runs with filters “Which workflow runs failed in my Dify app this week?” Resume a workflow run's event stream “How do I reconnect to a workflow run's event stream after my connection drops?” Run the app's latest published workflow “How do I trigger my published workflow from code and get its outputs?”

Dify Knowledge Bases API Create an empty knowledge base “How do I create a new, empty knowledge base before adding documents?” List knowledge bases in the workspace “Which knowledge bases exist in my Dify workspace?” Get a knowledge base's settings and stats “What embedding model and retrieval settings does a knowledge base use?” Change a knowledge base's name or settings “Can I rename an existing knowledge base or change its description?”

Dify Annotations API Add a predefined question-answer annotation “How do I make my chatbot always give a fixed answer to a specific question?” List a chat app's annotations “Which canned question-answer annotations does my Dify chatbot currently have?” Edit an existing annotation's question and answer “Can I change the answer on an annotation I already created?” Delete an annotation and its hit history “What happens to an annotation's hit history when I remove it?”

Dify Conversations API List an end user's conversations “How do I show a user their past chat conversations, most recent first?” Read a conversation's message history “What messages were exchanged in a given conversation?” List the variables stored in a conversation “Which conversation variables has my chatflow stored for this chat?” Rename or auto-title a conversation “Can I give a conversation a custom title shown in the chat list?”

Dify Knowledge Pipeline API Upload a file for a knowledge pipeline run “How do I upload a local file to feed into a knowledge pipeline?” List a pipeline's datasource nodes and plugins “Which datasource nodes and plugins are configured in my knowledge pipeline?” Run a single datasource node in a pipeline “Can I test just one datasource node of my knowledge pipeline on its own?” Run the full knowledge pipeline “How do I run my whole knowledge pipeline over a set of datasources?”

Dify Applications API Get an app's name, mode and author “What is the name, description and mode of the Dify app behind my API key?” Get an app's input form and feature settings “Which input variables does my app's user input form expect?” Get the icons of the tools an app uses “What icons should I display for the tools this app calls?” Get the hosted web app's branding settings “What title, icon and theme colors does the app's hosted web app use?”

Dify Chat Messages API Send a message to a chat app and get a reply “How do I send a user's message to my Dify chatbot and get the assistant's reply?” Stop a streaming chat reply mid-generation “Can I cancel a chat response that is still streaming?” Get suggested follow-up questions for a message “What follow-up questions does the app suggest after a given answer?”

Dify Feedback API Like, dislike or revoke feedback on a message “How do I record a thumbs up or thumbs down on an assistant reply?” List all feedback on an app's messages “What feedback have users and admins left across my Dify app?”

Showing 12 of 18 APIs with phrasing — see every API.

Kin Score

Kin Score How this is scored →
scored 2026-11-06 · rubric v0.27.0

Composite quality — 78.4/100 · exemplar

Contract Quality 12.4 / 19

Developer Ergonomics 12.8 / 15

Access Clarity 15.0 / 15

Operational Transparency 8.7 / 10

Contract Governance 2.9 / 9

Discoverability 5.6 / 8

Regulatory Posture 4.9 / 15

Create-or-Update Ergonomics 0.0 / 10

Agent readiness — 41/100 · agent ready

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 0 / 6

MCP Server 12 / 12

Machine-Readable Auth 10 / 10

Idempotency 0 / 9

Stable Error Semantics 8 / 8

Request/Response Examples 7 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 6 / 6

Agent Skills 5 / 5

Well-Known Catalog 4 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 0 / 4

Delegated User Identity 0 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Well-Known Document 0 / 5

Pagination 5 / 5

Distinct Operations 3 / 3

MCP Tool Quality 6 / 6

Regulatory Posture applies to this provider. Its tags matched the Horizontal (data, software, accessibility, platform) regime, so Regulatory Posture carries 15 points of the composite. If this regime is wrong for your business, say so on your provider repo — the applicability map is public and we will correct it.

Create-or-Update Ergonomics applies to this provider. This API accepts writes, so it carries 10 points of the composite. It is scored from the published contracts themselves: whether a caller can create-or-update in one call, whether the write accepts a key the caller already holds, and whether the response says which branch ran. Without that, every write needs a search-and-branch in front of it, and the first time that check is skipped a duplicate record is created. Scored against the observed mean rather than raw — a provider at the catalog average is unchanged by this facet, not penalised by it.

The six quality facets above are damped to 75 points between them, because the conditional facet above carries the other 25. That is why each facet's contribution is shown against a damped maximum: raising a quality facet moves the composite by 75% of its nominal weight, not 100%. The full arithmetic is at apis.io/rating/.

Show this score on your site.

It updates itself when the score changes. Paste this where you link to your API docs:

<a href="https://apis.io/providers/dify/"><img src="https://apis.io/badge/dify/card.svg" alt="Dify on APIs.io — Kin Score by API Evangelist"></a>

Other styles, a README pill and a shields.io endpoint are on the badge page.

Raise your score.

Agent readiness — checks not met, largest first (exact, from this profile):

Idempotency +9 pts — OpenAPI mutating operations declare an idempotency key — a header, a request-body property, or a named de-duplication token whose own description says so (verified); else common[].type matches /idempoten/i (documented)
A2A Agent Card +8 pts — a2a/-a2a.yml manifest, graded on conformance.grade against A2A 1.0.0
Registration Without a Human +6 pts — a `registration_endpoint` in the served RFC 8414 / OIDC discovery document
Delegated User Identity +6 pts — a served discovery document listing authorization_code in grant_types_supported (served), else an oauth2 authorizationCode flow or openIdConnect declared in an OpenAPI (documented)
Documented Reversibility +6 pts — a reversal operation in the contract, graded up when a window is documented too
Protected Resource Metadata +5 pts — a served /.well-known/oauth-protected-resource carrying `resource` (documented), and naming its authorization_servers (verified)

3 more unmet checks in the Agent Readiness table above.

Kin Score — facets with the most composite points still available (weight × headroom):

Contract Quality scores 65.9 — up to +8.5 composite points
Contract Governance scores 31.8 — up to +8.2 composite points
Developer Ergonomics scores 85.0 — up to +3.0 composite points

Each check links to what satisfies it. Publish the artifact, or tell us where it already lives, and the score moves on the next scoring run.

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. Every facet and dimension name above is a link: it opens that measurement's own page — what it means, the exact checks that feed it, how the whole catalog distributes on it, and the providers at the top of it. This rating is computed from the provider profile at artifacts.apis.io/dify/apis.yml: open an issue on github.com/api-evangelist/dify to ask a question or point us at an artifact you publish. Submit an artifact on GitHub — free → Manage your own listing — the Influence plan, $499/mo →

Markets this provider is in provisional

The Kin Score Market layer reads a provider inside its market: its position, and how deep its integrations go. Depth is only comparable within a position. Provisional and unweighted: not part of the Kin Score or agent readiness.

Market	Position	Depth	Registered MCP server	Declares compatibility
Agent Skills (SKILL.md packages)	standard	30.4	-	2
Atlassian Marketplace (builders on Jira, Confluence, Bitbucket)	standard	30.4	-	2
Red Hat Certified Ecosystem (certified partner containers + certified OpenShift operators)	standard	30.4	-	2

Registered MCP server and declares compatibility are report only — not weighted. Undeclared means we found nothing we can read, so there is no number: we never infer integrations.

Standards implemented 3

Standards this provider implements or carries. De facto ones are profiled and measured by the API Commons; formal ones come from the standards directory and are linked by the provider's own tags. The evidence column says how each claim was established — not that it was made.

Agent2Agent

tagged — the provider's own APIs.json carries the standard as a tag; implementation not verified

Model Context Protocol (MCP)

measured — observed by APIs.io (platform)

OpenAPI

measured — observed by APIs.io (published)

APIs 18

Individual APIs this provider publishes, each with its own machine-readable definition.

Dify Conversations API

Operations related to managing conversations. 6 operation(s) from the Dify Service API.

Dify Files API

File upload and preview operations. 2 operation(s) from the Dify Service API.

Dify Applications API

Operations to retrieve application settings and information. 4 operation(s) from the Dify Service API.

Dify Annotations API

Operations related to managing annotations for direct replies. 6 operation(s) from the Dify Service API.

Dify Audio API

Text-to-Speech and Speech-to-Text operations. 2 operation(s) from the Dify Service API.

Dify Feedback API

User feedback operations. 2 operation(s) from the Dify Service API.

Dify End Users API

Operations related to end user information. 1 operation(s) from the Dify Service API.

Dify Human Input API

Endpoints for resuming paused workflows that require human input. 2 operation(s) from the Dify Service API.

Dify Documents API

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

Dify Chunks API

Operations for managing document chunks and child chunks. 9 operation(s) from the Dify Service API.

Dify Knowledge Tags API

Operations for managing knowledge base tags and tag bindings. 7 operation(s) from the Dify Service API.

Dify Metadata API

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

Dify Models API

Operations for retrieving available models. 1 operation(s) from the Dify Service API.

Dify Knowledge Pipeline API

Operations for managing and running knowledge pipelines, including datasource plugins and pipeline execution. 4 operation(s) from the Dify Service API.

Dify Chat Messages API

Operations related to chat messages and interactions.

Dify Completion Messages API

Operations related to text generation and completion.

Dify Knowledge Bases API

Operations for managing knowledge bases, including creation, configuration, and retrieval.

Dify Workflow Runs API

Operations for executing and managing workflows.

Scroll for all 18

Open Collections 7

Open, tool-agnostic API collections (OpenAPI-derived and Bruno).

Dify Chat API

OPEN COLLECTION

Dify Chat Completion API

OPEN COLLECTION

Dify Chat Conversations API

OPEN COLLECTION

Dify Chat Datasets API

OPEN COLLECTION

Dify Chat Files API

OPEN COLLECTION

Dify Chat Workflows API

OPEN COLLECTION

Dify API

OPEN COLLECTION

Scroll for all 7

MCP Servers 1

Model Context Protocol servers that expose these APIs to AI agents.

Dify Docs MCP

Dify's MCP posture has two distinct surfaces. (1) A live, anonymous, remote documentation MCP server at https://docs.dify.ai/mcp, confirmed by an unauthenticated tools/list call...

MCP SERVER

Agent Skills 4

Packaged agent skills for driving this provider's APIs from an AI assistant.

dify-chat-app-conversation

AGENT SKILL

dify-knowledge-base-ingest

AGENT SKILL

Dify

AGENT SKILL

dify-workflow-run

AGENT SKILL

Dify API pricing

Prices published by Dify, read 2026-10-28 from dify.ai/pricing. A free plan or tier is listed.

Plan	Price
Sandbox	Free Includes: 200 message credits, 1 Team Workspace, 1 Team Member, 5 Apps, 50 Knowledge Documents, 50MB Knowledge
Professional	$590 per workspace/ year Includes: 5,000 message credits / month, 1 Team Workspace, 3 Team Members, 50 Apps, 500 Knowledge Documents, 5
Team	$1590 per workspace/ year Includes: 10,000 message credits / month, 1 Team Workspace, 50 Team Members, 200 Apps, 1,000 Knowledge Documen
Enterprise	Custom Includes: Commercial License Authorization, SSO, advanced security, professional support
Community	Free Includes: All Core Features Released Under the Public Repository, Single Workspace

Plan details, limits and sources →

Rate limits

Knowledge Request Rate Limit — Sandbox: 10 knowledge requests
Knowledge Request Rate Limit — Professional: 100 knowledge requests
Knowledge Request Rate Limit — Team: 1000 knowledge requests

All 5 limits →

Billed by: workspace · FinOps profile →

Pricing Plans 1

Published pricing tiers and plan structures.

Dify Plans Pricing

5 plans

PLANS

Rate Limits 1

Documented rate limits and quota policies.

Dify Rate Limits

5 limits

RATE LIMITS

Service Levels 1

Uptime the provider promises or reports, as SLA4OAI. Read from its own pages; APIs.io runs no monitors.

Dify

SLA

FinOps 1

Cost, billing, and metering signals for API financial operations.

Dify Finops

FINOPS

Event Specifications 1

AsyncAPI definitions for this provider's event-driven and streaming APIs.

Dify Events

ASYNCAPI

Spectral Rules 1

Spectral governance rulesets for linting and validating these APIs.

Dify API Rules

64 rules · 52 errors 10 warnings 2 info

SPECTRAL

OpenAPI Overlays 19

Overlays applied on top of this provider's contracts. Each card says who wrote it: a document the provider publishes, or one API Evangelist derived or generated.

Dify Annotations Api Phrasing Overlay

7 actions · phrasing · dify-annotations-api-openapi.yml

GENERATED

Dify Applications Api Phrasing Overlay

5 actions · phrasing · dify-applications-api-openapi.yml

GENERATED

Dify Audio Api Phrasing Overlay

3 actions · phrasing · dify-audio-api-openapi.yml

GENERATED

Dify Chat Messages Api Phrasing Overlay

4 actions · phrasing · dify-chat-messages-api-openapi.yml

GENERATED

Dify Chunks Api Phrasing Overlay

10 actions · phrasing · dify-chunks-api-openapi.yml

GENERATED

Dify Completion Messages Api Phrasing Overlay

3 actions · phrasing · dify-completion-messages-api-openapi.yml

GENERATED

Dify Conversations Api Phrasing Overlay

7 actions · phrasing · dify-conversations-api-openapi.yml

GENERATED

Dify Documents Api Phrasing Overlay

13 actions · phrasing · dify-documents-api-openapi.yml

GENERATED

Dify End Users Api Phrasing Overlay

2 actions · phrasing · dify-end-users-api-openapi.yml

GENERATED

Dify Feedback Api Phrasing Overlay

3 actions · phrasing · dify-feedback-api-openapi.yml

GENERATED

Dify Files Api Phrasing Overlay

3 actions · phrasing · dify-files-api-openapi.yml

GENERATED

Dify Human Input Api Phrasing Overlay

3 actions · phrasing · dify-human-input-api-openapi.yml

GENERATED

Dify Knowledge Bases Api Phrasing Overlay

7 actions · phrasing · dify-knowledge-bases-api-openapi.yml

GENERATED

Dify Knowledge Pipeline Api Phrasing Overlay

5 actions · phrasing · dify-knowledge-pipeline-api-openapi.yml

GENERATED

Dify Metadata Api Phrasing Overlay

8 actions · phrasing · dify-metadata-api-openapi.yml

GENERATED

Dify Models Api Phrasing Overlay

2 actions · phrasing · dify-models-api-openapi.yml

GENERATED

Dify Service Api Overlay

12 actions · update · dify-service-api-openapi.json

GENERATED

Dify Tags Api Phrasing Overlay

8 actions · phrasing · dify-tags-api-openapi.yml

GENERATED

Dify Workflow Runs Api Phrasing Overlay

7 actions · phrasing · dify-workflow-runs-api-openapi.yml

GENERATED

Scroll for all 19

Security Posture 4

Authentication, domain security, vulnerability disclosure, and trust-center signals.

Dify Authentication

http · 1 scheme

SECURITY

Dify Domain Security

TLSv1.3 · HSTS · DMARC

SECURITY

Dify Vulnerability Disclosure

Hackerone

SECURITY

Dify Trust Center

SOC 2

SECURITY

Agentic Access 1

Recommended x-agentic-access execution contracts for AI agents.

Dify Agentic Access

82 operations · 49 acting · 3 human-in-the-loop

82 operations · 49 acting

AGENTIC

Resources

Get Started 5

Portal, sign-up, and the first successful call

Sandbox

DeveloperPortal

GettingStarted

SignUp

Login

Documentation 3

Reference material describing how the API behaves

OpenAPI

OpenAPI

Documentation

Documentation

APIReference

APIReference

Agent Surfaces 6

MCP servers, agent skills, and machine-readable catalogs

MCPServer

AgentSkill

WellKnown

AgenticAccess

LLMsTxt

LlmsText

Design & Contract 7

Pagination, idempotency, versioning, errors, and events

Conventions

ErrorCatalog

DataModel

Lifecycle

Conformance

Components

Webhooks

Scroll for all 7

Build 5

SDKs, sample code, and the tooling you integrate with

Packages

SDKs

CLI

ToolCrosswalk

GitHubOrganization

GitHubOrganization

Access & Security 6

Authentication, authorization, and security posture

Authentication

Compliance

TrustCenter

Security

VulnerabilityDisclosure

VulnerabilityDisclosure

DomainSecurity

DomainSecurity

Operate 6

Status, limits, changes, and where to get help

ChangeLog

StatusPage

RateLimits

Support

Community

RoadMap

Commercial 5

Pricing, plans, and the legal terms of use

Plans

FinOps

Pricing

TermsOfService

PrivacyPolicy

Company 4

The organization behind the API

Website

Website

Blog

Blog

LinkedIn

Twitter

Twitter

Other 4

Properties that don't map to a standard resource type

CapabilityMap

Overlay

AgentCard

Marketplace

Source (apis.yml)

aid: dify
url: https://raw.githubusercontent.com/api-evangelist/dify/refs/heads/main/apis.yml
x-docs-platform: mintlify
x-docs-platform-confidence: medium
x-docs-platform-checked: 2026-09-25
x-docs-hosting: vercel
apis:
- aid: dify:dify-conversations-api
  name: Dify Conversations API
  description: Operations related to managing conversations. 6 operation(s) from the Dify Service API.
  humanURL: https://docs.dify.ai/en/api-reference/conversations/list-conversations
  baseURL: https://api.dify.ai/v1
  tags:
  - Conversations
  - Messaging
  properties:
  - type: OpenAPI
    url: openapi/dify-conversations-api-openapi.yml
  - type: APIReference
    url: https://docs.dify.ai/en/api-reference/conversations/list-conversations
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/dify.png
- aid: dify:dify-files-api
  name: Dify Files API
  description: File upload and preview operations. 2 operation(s) from the Dify Service API.
  humanURL: https://docs.dify.ai/en/api-reference/files/upload-file
  baseURL: https://api.dify.ai/v1
  tags:
  - File
  - File Upload
  properties:
  - type: OpenAPI
    url: openapi/dify-files-api-openapi.yml
  - type: APIReference
    url: https://docs.dify.ai/en/api-reference/files/upload-file
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/dify.png
- aid: dify:dify-applications-api
  name: Dify Applications API
  description: Operations to retrieve application settings and information. 4 operation(s) from the Dify Service API.
  humanURL: https://docs.dify.ai/en/api-reference/applications/get-app-info
  baseURL: https://api.dify.ai/v1
  tags:
  - Application
  - Configuration
  tags_raw:
  - Applications
  - Configuration
  properties:
  - type: OpenAPI
    url: openapi/dify-applications-api-openapi.yml
  - type: APIReference
    url: https://docs.dify.ai/en/api-reference/applications/get-app-info
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/dify.png
- aid: dify:dify-annotations-api
  name: Dify Annotations API
  description: Operations related to managing annotations for direct replies. 6 operation(s) from the Dify Service API.
  humanURL: https://docs.dify.ai/en/api-reference/annotations/list-annotations
  baseURL: https://api.dify.ai/v1
  tags:
  - Annotation
  - Quality
  tags_raw:
  - Annotations
  - Quality
  properties:
  - type: OpenAPI
    url: openapi/dify-annotations-api-openapi.yml
  - type: APIReference
    url: https://docs.dify.ai/en/api-reference/annotations/list-annotations
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/dify.png
- aid: dify:dify-audio-api
  name: Dify Audio API
  description: Text-to-Speech and Speech-to-Text operations. 2 operation(s) from the Dify Service API.
  humanURL: https://docs.dify.ai/en/api-reference/audio/convert-audio-to-text
  baseURL: https://api.dify.ai/v1
  tags:
  - Audio
  - Speech-to-Text
  - Text-to-Speech
  tags_raw:
  - Audio
  - Speech To Text
  - Text To Speech
  properties:
  - type: OpenAPI
    url: openapi/dify-audio-api-openapi.yml
  - type: APIReference
    url: https://docs.dify.ai/en/api-reference/audio/convert-audio-to-text
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/dify.png
- aid: dify:dify-feedback-api
  name: Dify Feedback API
  description: User feedback operations. 2 operation(s) from the Dify Service API.
  humanURL: https://docs.dify.ai/en/api-reference/feedback/submit-message-feedback
  baseURL: https://api.dify.ai/v1
  tags:
  - Feedback
  - Quality
  properties:
  - type: OpenAPI
    url: openapi/dify-feedback-api-openapi.yml
  - type: APIReference
    url: https://docs.dify.ai/en/api-reference/feedback/submit-message-feedback
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/dify.png
- aid: dify:dify-end-users-api
  name: Dify End Users API
  description: Operations related to end user information. 1 operation(s) from the Dify Service API.
  humanURL: https://docs.dify.ai/en/api-reference/end-users/get-end-user-info
  baseURL: https://api.dify.ai/v1
  tags:
  - User
  - Identity
  tags_raw:
  - Users
  - Identity
  properties:
  - type: OpenAPI
    url: openapi/dify-end-users-api-openapi.yml
  - type: APIReference
    url: https://docs.dify.ai/en/api-reference/end-users/get-end-user-info
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/dify.png
- aid: dify:dify-human-input-api
  name: Dify Human Input API
  description: Endpoints for resuming paused workflows that require human input. 2 operation(s) from the Dify Service API.
  humanURL: https://docs.dify.ai/en/api-reference/human-input/get-human-input-form
  baseURL: https://api.dify.ai/v1
  tags:
  - Human-in-the-Loop
  - Workflows
  tags_raw:
  - Human In The Loop
  - Workflows
  properties:
  - type: OpenAPI
    url: openapi/dify-human-input-api-openapi.yml
  - type: APIReference
    url: https://docs.dify.ai/en/api-reference/human-input/get-human-input-form
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/dify.png
- aid: dify:dify-documents-api
  name: Dify Documents API
  description: Operations for creating, updating, and managing documents within a knowledge base. 12 operation(s) from the
    Dify Service API.
  humanURL: https://docs.dify.ai/en/api-reference/documents/list-documents
  baseURL: https://api.dify.ai/v1
  tags:
  - Documents
  - Knowledge Management
  tags_raw:
  - Documents
  - Knowledge Management
  - Knowledge-Management
  properties:
  - type: OpenAPI
    url: openapi/dify-documents-api-openapi.yml
  - type: APIReference
    url: https://docs.dify.ai/en/api-reference/documents/list-documents
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/dify.png
- aid: dify:dify-chunks-api
  name: Dify Chunks API
  description: Operations for managing document chunks and child chunks. 9 operation(s) from the Dify Service API.
  humanURL: https://docs.dify.ai/en/api-reference/chunks/list-chunks
  baseURL: https://api.dify.ai/v1
  tags:
  - Chunks
  - Knowledge Management
  - RAG
  tags_raw:
  - Chunks
  - Knowledge Management
  - RAG
  - Knowledge-Management
  properties:
  - type: OpenAPI
    url: openapi/dify-chunks-api-openapi.yml
  - type: APIReference
    url: https://docs.dify.ai/en/api-reference/chunks/list-chunks
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/dify.png
- aid: dify:dify-tags-api
  name: Dify Knowledge Tags API
  description: Operations for managing knowledge base tags and tag bindings. 7 operation(s) from the Dify Service API.
  humanURL: https://docs.dify.ai/en/api-reference/knowledge-bases/list-knowledge-bases
  baseURL: https://api.dify.ai/v1
  tags:
  - Tags
  - Knowledge Management
  tags_raw:
  - Tags
  - Knowledge Management
  - Knowledge-Management
  properties:
  - type: OpenAPI
    url: openapi/dify-tags-api-openapi.yml
  - type: APIReference
    url: https://docs.dify.ai/en/api-reference/knowledge-bases/list-knowledge-bases
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/dify.png
- aid: dify:dify-metadata-api
  name: Dify Metadata API
  description: Operations for managing knowledge base metadata fields and document metadata values. 7 operation(s) from the
    Dify Service API.
  humanURL: https://docs.dify.ai/en/api-reference/knowledge-bases/list-knowledge-bases
  baseURL: https://api.dify.ai/v1
  tags:
  - Metadata
  - Knowledge Management
  tags_raw:
  - Metadata
  - Knowledge Management
  - Knowledge-Management
  properties:
  - type: OpenAPI
    url: openapi/dify-metadata-api-openapi.yml
  - type: APIReference
    url: https://docs.dify.ai/en/api-reference/knowledge-bases/list-knowledge-bases
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/dify.png
- aid: dify:dify-models-api
  name: Dify Models API
  description: Operations for retrieving available models. 1 operation(s) from the Dify Service API.
  humanURL: https://docs.dify.ai/en/api-reference/knowledge-bases/list-knowledge-bases
  baseURL: https://api.dify.ai/v1
  tags:
  - Models
  - Artificial Intelligence
  properties:
  - type: OpenAPI
    url: openapi/dify-models-api-openapi.yml
  - type: APIReference
    url: https://docs.dify.ai/en/api-reference/knowledge-bases/list-knowledge-bases
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/dify.png
- aid: dify:dify-knowledge-pipeline-api
  name: Dify Knowledge Pipeline API
  description: Operations for managing and running knowledge pipelines, including datasource plugins and pipeline execution.
    4 operation(s) from the Dify Service API.
  humanURL: https://docs.dify.ai/en/api-reference/knowledge-bases/list-knowledge-bases
  baseURL: https://api.dify.ai/v1
  tags:
  - Pipelines
  - Knowledge Management
  tags_raw:
  - Pipelines
  - Knowledge Management
  - Knowledge-Management
  properties:
  - type: OpenAPI
    url: openapi/dify-knowledge-pipeline-api-openapi.yml
  - type: APIReference
    url: https://docs.dify.ai/en/api-reference/knowledge-bases/list-knowledge-bases
  image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/dify.png
- aid: dify:dify-chat-messages-api
  name: Dify Chat Messages API
  description: Operations related to chat messages and interactions.
  humanURL: https://docs.dify.ai/
  baseURL: https://api.dify.ai/v1
  tags:
  - Chat Messages
  properties:
  - type: OpenAPI
    url: openapi/dify-chat-messages-api-openapi.yml
  - type: Documentation
    url: https://docs.dify.ai/
  - type: APIReference
    url: https://docs.dify.ai/en/api-reference
  - type: GettingStarted
    url: https://docs.dify.ai/en/api-reference/guides/get-started
- aid: dify:dify-completion-messages-api
  name: Dify Completion Messages API
  description: Operations related to text generation and completion.
  humanURL: https://docs.dify.ai/
  baseURL: https://api.dify.ai/v1
  tags:
  - Completion Messages
  properties:
  - type: OpenAPI
    url: openapi/dify-completion-messages-api-openapi.yml
  - type: Documentation
    url: https://docs.dify.ai/
  - type: APIReference
    url: https://docs.dify.ai/en/api-reference
  - type: GettingStarted
    url: https://docs.dify.ai/en/api-reference/guides/get-started
- aid: dify:dify-knowledge-bases-api
  name: Dify Knowledge Bases API
  description: Operations for managing knowledge bases, including creation, configuration, and retrieval.
  humanURL: https://docs.dify.ai/
  baseURL: https://api.dify.ai/v1
  tags:
  - Knowledge Bases
  properties:
  - type: OpenAPI
    url: openapi/dify-knowledge-bases-api-openapi.yml
  - type: Documentation
    url: https://docs.dify.ai/
  - type: APIReference
    url: https://docs.dify.ai/en/api-reference
  - type: GettingStarted
    url: https://docs.dify.ai/en/api-reference/guides/get-started
- aid: dify:dify-workflow-runs-api
  name: Dify Workflow Runs API
  description: Operations for executing and managing workflows.
  humanURL: https://docs.dify.ai/
  baseURL: https://api.dify.ai/v1
  tags:
  - Workflow Runs
  properties:
  - type: OpenAPI
    url: openapi/dify-workflow-runs-api-openapi.yml
  - type: Documentation
    url: https://docs.dify.ai/
  - type: APIReference
    url: https://docs.dify.ai/en/api-reference
  - type: GettingStarted
    url: https://docs.dify.ai/en/api-reference/guides/get-started
name: Dify
tags:
- Artificial Intelligence
- LLMOps
- Backend-as-a-Service
- Agents
- Workflows
- Knowledge Management
- RAG
- MCP
- Low-Code
- Open Source
- A2A
tags_raw:
- Artificial Intelligence
- LLMOps
- Backend-As-A-Service
- Agents
- Workflows
- Knowledge Management
- RAG
- Model Context Protocol
- Low Code
- Open Source
- Knowledge-Management
- Open-Source
- A2A
type: Index
deliveryModel:
  model: saas+self-hosted
  open_source: true
  commercial: true
  callable_host: true
  label: Hosted service or self-hosted · open-source core with a commercial cloud and enterprise edition
  confidence: high
  source:
  - openapi
  - pricing
  - github
  generated: '2026-09-06'
  method: derived
  note: 'Corrected 2026-09-06: open_source was recorded as false. Dify ships a free, self-deployable Community Edition under
    the Dify Open Source License (github.com/langgenius/dify, 154k stars) alongside Dify Cloud and a commercial Enterprise
    edition; the pricing page lists all three.'
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  gated: none
  gated_source:
  - onboarding
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  - rate-limits
  - security
  - sandbox
  generated: '2026-11-06'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/dify.png
access: 3rd-Party
created: '2025-02-08'
modified: '2026-09-06'
position: Consuming
description: Dify is an open-source platform for building AI applications, combining Backend-as-a-Service and LLMOps to streamline
  the development of generative AI solutions for developers and non-technical innovators alike. Teams build agentic workflows,
  chatflows, agents and RAG knowledge pipelines on a visual canvas, then publish each one as a web app, an embeddable widget,
  a REST API or an MCP server. Dify is operated by Langgenius, Inc. and ships as Dify Cloud, a self-hosted Community Edition
  and a commercial Enterprise edition.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com
specificationVersion: '0.23'
common:
- type: CapabilityMap
  url: capabilities/dify-capability-edges.yml
  name: Dify Business Capability Map
- type: OpenAPI
  url: openapi/_original/dify-service-api-openapi.json
- type: Overlay
  url: overlays/dify-service-api-overlay.yaml
- type: Authentication
  url: authentication/dify-authentication.yml
- type: Conventions
  url: conventions/dify-conventions.yml
- type: ErrorCatalog
  url: errors/dify-problem-types.yml
- type: DataModel
  url: data-model/dify-data-model.yml
- type: Lifecycle
  url: lifecycle/dify-lifecycle.yml
- type: ChangeLog
  url: changelog/dify-changelog.yml
- type: StatusPage
  url: https://status.dify.ai/
- type: Conformance
  url: conformance/dify-conformance.yml
- type: Compliance
  url: conformance/dify-conformance.yml
- type: TrustCenter
  url: security/dify-trust-center.yml
- type: Security
  url: security/dify-vulnerability-disclosure.yml
- type: VulnerabilityDisclosure
  url: security/dify-vulnerability-disclosure.yml
- type: DomainSecurity
  url: security/dify-domain-security.yml
- type: Packages
  url: packages/dify-packages.yml
- type: SDKs
  url: packages/dify-packages.yml
- type: CLI
  url: cli/dify-cli.yml
- type: Components
  url: components/dify-components.yml
- type: Sandbox
  url: sandbox/dify-sandbox.yml
- type: Plans
  url: plans/dify-plans-pricing.yml
- type: RateLimits
  url: rate-limits/dify-rate-limits.yml
- type: FinOps
  url: finops/dify-finops.yml
- type: Webhooks
  url: asyncapi/dify-events.yml
- type: MCPServer
  url: mcp/dify-mcp.yml
- type: ToolCrosswalk
  url: mcp/dify-tool-crosswalk.yml
- type: AgentCard
  url: a2a/dify-a2a.yml
- type: AgentSkill
  url: skills/_index.yml
- type: WellKnown
  url: well-known/dify-well-known.yml
- type: AgenticAccess
  url: agentic-access/dify-agentic-access.yml
- type: LLMsTxt
  url: llms/dify-llms.txt
- type: Website
  name: Dify.AI — The Innovation Engine for Generative AI Applications
  url: https://dify.ai/
- type: DeveloperPortal
  name: Dify Documentation
  url: https://docs.dify.ai/
- type: Documentation
  name: Welcome to Dify
  url: https://docs.dify.ai/
- type: APIReference
  name: Dify API Reference
  url: https://docs.dify.ai/en/api-reference
- type: GettingStarted
  name: Get Started with the Dify API
  url: https://docs.dify.ai/en/api-reference/guides/get-started
- type: LlmsText
  name: Dify Docs llms.txt
  url: https://docs.dify.ai/llms.txt
- type: Pricing
  name: Dify AI — Plans and Pricing
  url: https://dify.ai/pricing
- type: SignUp
  name: Sign up for Dify Cloud
  url: https://cloud.dify.ai/signup
- type: Login
  name: Sign in to Dify Cloud
  url: https://cloud.dify.ai/signin
- type: TermsOfService
  name: Dify.AI Terms of Service
  url: https://dify.ai/legal/terms-of-service
- type: PrivacyPolicy
  name: Dify.AI Privacy Policy
  url: https://dify.ai/legal/privacy-policy
- type: Support
  name: Dify Discord community
  url: https://discord.gg/FngNHpbcY7
- type: Community
  name: Dify GitHub Discussions
  url: https://github.com/langgenius/dify/discussions
- type: Blog
  name: Dify Blog
  url: https://dify.ai/blog
- type: RoadMap
  name: Dify Roadmap
  url: https://roadmap.dify.ai/roadmap
- type: Marketplace
  name: Dify Marketplace
  url: https://marketplace.dify.ai/
- type: GitHubOrganization
  url: https://github.com/langgenius
- type: LinkedIn
  url: https://www.linkedin.com/company/langgenius
- type: Twitter
  name: '@dify_ai'
  url: https://x.com/dify_ai
x-enrichment:
  date: '2026-09-06'
  status: enriched
  artifacts_added: 40
  pass: local-v3
x-a2a:
  verified: true
  probed: '2026-09-26'
  url: https://docs.dify.ai/.well-known/agent-card.json
  grade: conformant
  protocol_version: '0.3'
  control: 404

Dify API — frequently asked questions

Does Dify have an API?

Yes. APIs.io lists 18 APIs from Dify, including Dify Conversations API, Dify Files API and Dify Applications API, and 15 more.

Is there an OpenAPI specification for the Dify API?

Yes. APIs.io indexes 18 OpenAPI specifications for Dify, each linked for download from this page.

How do I authenticate with the Dify API?

Dify uses bearer-token authentication (http · 1 scheme). The details are profiled on APIs.io as Dify Authentication.

How much does the Dify API cost?

Dify publishes its prices; its Professional plan is $590 per workspace/ year as of 2026-10-28. APIs.io lists 5 pricing plans for Dify, with each plan's price, limits and inclusions under Pricing on this page.

Does Dify have an MCP server?

Yes. APIs.io lists 1 MCP server for Dify: Dify's MCP posture has two distinct surfaces. (1) A live, anonymous, remote documentation MCP server at https://docs.dify.ai/mcp, confirmed by an unauthenticated tools/list call that returned three re

Is the Dify API ready for AI agents?

Dify has a Kin Score of 78.4 out of 100 (exemplar) and an Agent Readiness score of 40.8 (agent-ready), scored by API Evangelist on 2026-11-06.

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/dify"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/dify/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/dify/evidence"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.