Delete Knowledge Tag | Dify Octri Demo

1 body field

tag_idstringrequired

ID of the tag to delete. See [List Knowledge Type Tags](/en/api-reference/tags/list-knowledge-tags).

3 status codes

204Success.

403`forbidden` : The API key is scoped to specific knowledge bases. This endpoint has no knowledge base ID in its path, so it requires a key with access to all knowledge bases.

One documented failure

forbidden
The API key is not authorized to access this knowledge base.
forbidden (key scope)

404`not_found` : The specified tag does not exist.

One documented failure

not_found
Tag not found
not_found

Error handling

A 403 is returned: forbidden : The API key is scoped to specific knowledge bases. This endpoint has no knowledge base ID in its path, so it requires a key with access to all knowledge bases. A 404 is returned: not_found : The specified tag does not exist.

import { Client } from "dify-octri-demo-sdk";

const client = new Client({
  baseUrl: "https://{api_base_url}",
  auth: { bearer: process.env.API_TOKEN },
});

const result = await client.tags.delete({ tagId: "3fa85f64-5717-4562-b3fc-2c963f66afa6" });

{
  "code": "forbidden",
  "message": "The API key is not authorized to access this knowledge base.",
  "status": 403
}

Request

Response

Errors