How to get the List of Agents/Apps

[akshay]

Hi Team,

I am currently doing a POC on Dify AI and need to retrieve the list of Agents/Apps programmatically.

I have checked all possible options but could not find any officially supported method.
Here’s what I have tried so far:

1. Reviewed Dify’s public REST API documentation
   – I found APIs for calling an app once its App ID is known,
   – but there is no documented endpoint to list all my apps/agents.

2. Checked the official SDKs (Python, Go, JS)
   – These also only allow interacting with an already known app,
   – There is no method like list_apps or list_agents.

3. Inspected the network calls used by the Dify Web Console
   – The UI calls an internal endpoint:
   GET /console/api/apps?page=...&mode=agent-chat
   – This works in the browser but uses internal console APIs,
   – and it requires session cookies, not API keys.

4. Explored open-source repo
   – The backend contains internal app-listing services,
   – but they do not appear to be exposed as a public API on Dify Cloud.

Because of this, I am unable to find a stable, supported, official way to fetch the Agents list programmatically.

My question:

Is there an officially supported API or SDK method to retrieve the list of agents/apps programmatically?
If yes, please share the documentation.
If not, is there a recommended workaround or planned support for this feature?

[kurokobo]

As far as I know, there’s no officially supported way to do that.

There are some unofficial community tools available on GitHub. My tool, PSDify, a PowerShell module for Dify, is also compatible with the latest cloud version.

Here’s an example where I connect to the cloud version of Dify (Connect-Dify) and retrieve a list of apps (Get-DifyApp).