Dify Octri Demo
GET/datasets/{dataset_id}/pipeline/datasource-plugins

List Datasource Plugins

Returns the datasource nodes configured in the knowledge pipeline, each with the plugin it uses and the metadata needed to run it.

2 parameters
dataset_idstringrequired
Knowledge base ID, from [List Knowledge Bases](/en/api-reference/knowledge-bases/list-knowledge-bases). For a scoped key, [copy the ID from the Dify URL](/en/api-reference/guides/knowledge#knowledge-base-id).
is_publishedbooleanoptional
Whether to read nodes from the published pipeline version rather than the draft.
Default:true

4 status codes
200List of datasource nodes configured in the pipeline.
credentialsarray<object>optional
Credentials available for authenticating with this datasource.
datasource_typestringoptional
Type of datasource. One of `local_file`, `online_document`, `online_drive`, `website_crawl`.
node_idstringoptional
ID of the datasource node in the pipeline workflow. Pass this as `node_id` to [Run Datasource Node](/en/api-reference/knowledge-pipeline/run-datasource-node), or as `start_node_id` to [Run Pipeline](/en/api-reference/knowledge-pipeline/run-pipeline).
plugin_idstringoptional
ID of the datasource plugin providing this node.
provider_namestringoptional
Provider name registered by the datasource plugin.
titlestringoptional
Display title configured for the node.
user_input_variablesarray<object>optional
Pipeline input variables the caller must supply for this datasource, derived from `{{#...#}}` references in the node's datasource parameters. Each item follows the pipeline variable schema used by the workflow.
400`invalid_param` : The knowledge base has no processing pipeline configured.

One documented failure

  • invalid_param

    Pipeline not found

    invalid_param

403- `forbidden` : API access is not enabled for this knowledge base. - `forbidden` : The API key is scoped to specific knowledge bases, and this knowledge base is not one of them.

One documented failure

  • forbidden

    Dataset api access is not enabled.

    forbidden (api access)

404`not_found` : No knowledge base matches `dataset_id`.

One documented failure

  • not_found

    Dataset not found.

    not_found

Error handling

A 400 is returned: invalid_param : The knowledge base has no processing pipeline configured. A 403 is returned: - forbidden : API access is not enabled for this knowledge base.

  • forbidden : The API key is scoped to specific knowledge bases, and this knowledge base is not one of them. A 404 is returned: not_found : No knowledge base matches dataset_id.