Dify Octri Demo
GET/datasets/{dataset_id}/tags

List tags bound to a knowledge base

Lists the tags bound to a knowledge base. Use dataset_id to identify the knowledge base whose tags you want to retrieve; the response includes the tags and their total count.

1 parameter
dataset_idstringrequired
The UUID of the knowledge base whose bound tags you want to retrieve.

3 status codes
200Returns the bound tags in `data` and their total count in `total`.
dataarray<object>optional
List of tags bound to this knowledge base.
totalintegeroptional
Total number of tags bound to this knowledge base.
403Returned when API access is disabled for the knowledge base or the API key is not scoped to it.

One documented failure

  • forbidden

    Dataset api access is not enabled.

    forbidden (api access)

404Returned when the knowledge base is not found.

One documented failure

  • not_found

    Dataset not found.

    not_found

Error handling

A 403 is returned when API access is disabled for the knowledge base or the API key is not scoped to it. A 404 is returned when the knowledge base is not found; the dataset_id path parameter must be a UUID identifying an existing knowledge base.