Dify Octri Demo
GET/datasets

List Knowledge Bases

Returns a paginated list of knowledge bases, optionally filtered by keyword or tags.

5 parameters
pageintegeroptional
Page number. Values below `1` are treated as `1`.
Default:1
limitintegeroptional
Number of items per page. Server caps at `100`, and values below `1` are treated as `1`.
Default:20
keywordstringoptional
Search keyword to filter by name.
include_allbooleanoptional
Whether to include all knowledge bases regardless of permissions.
Default:false
tag_idsarray<string>optional
Tag IDs to filter by. Get tag IDs from [List Knowledge Type Tags](/en/api-reference/tags/list-knowledge-tags).

2 status codes
200List of knowledge bases.
dataarray<object>optional
Array of knowledge base objects.
has_morebooleanoptional
Whether more items exist on the next page.
limitintegeroptional
Number of items per page.
pageintegeroptional
Current page number.
totalintegeroptional
Total number of matching items.
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)

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.