Get Started with the Dify API

Every app you publish in Dify doubles as a REST API, and so do your knowledge bases. You call the same app your end users interact with, from your own backend, with an API key.

Get an API Key

Call the API from your backend only. A key embedded in frontend code or a client app can be extracted and abused.

For an app, create an API key from inside the app itself. The key is scoped to that one app, and one key serves all your end users.
Your calls tell people apart with a per-person user value. See End User Identity for details.
For knowledge bases, see the Knowledge Base API guide.

Make Your First Call

Most requests carry the key as a Bearer token. For Dify Cloud, the base URL is https://api.dify.ai/v1; for self-hosted deployments, use your own instance’s API base URL. The fastest first call needs no code: open Get App Info, click Try it, paste your key into the Authorization field, and press Send. It works for every app type. The same call from a terminal:

curl https://api.dify.ai/v1/info \
  -H "Authorization: Bearer $DIFY_API_KEY"

A response like this confirms the key works and shows which app it belongs to:

{
  "name": "My Chat App",
  "description": "A helpful assistant",
  "tags": ["assistant"],
  "mode": "chat",
  "author_name": "Dify Team"
}

Using a knowledge base API key? See the Knowledge Base API guide.

Find Your App Type’s Endpoints

See each app type’s own overview page for its full API surface:

Chatflow (advanced-chat)
Workflow (workflow)
Agent (agent)
Chatbot and Legacy Agent (chat, agent-chat)
Text Generator (completion)
Knowledge Base

Last modified on October 28, 2026

Guides

App APIs

Knowledge APIs

Get Started with the Dify API

Get an API Key

Make Your First Call

Find Your App Type’s Endpoints

​Get an API Key

​Make Your First Call

​Find Your App Type’s Endpoints

Get an API Key

Make Your First Call

Find Your App Type’s Endpoints