Skip to main content
POST
/
datasets
/
tags
Error
A valid request URL is required to generate request examples
{
  "id": "f4b5c6d7-e8f9-0a1b-2c3d-4e5f6a7b8c9d",
  "name": "Product Docs",
  "type": "knowledge",
  "binding_count": "0"
}

Documentation Index

Fetch the complete documentation index at: https://docs.dify.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

API Key authentication. For all API requests, include your API Key in the Authorization HTTP Header, prefixed with Bearer. Example: Authorization: Bearer {API_KEY}. Strongly recommend storing your API Key on the server-side, not shared or stored on the client-side, to avoid possible API-Key leakage that can lead to serious consequences.

Body

application/json
​
name
string
required

Tag name.

Required string length: 1 - 50

Response

200 - application/json

Tag created successfully.

​
id
string

Tag identifier.

​
name
string

Tag display name.

​
type
string

Tag type. Always knowledge for knowledge base tags.

​
binding_count
string | null

Number of knowledge bases bound to this tag.