Skip to main content
All commands below assume you’re signed in and that your administrator has permitted you to run the apps you’re targeting.

​
Send a Message

Send a message to a Chatbot, Chatflow, Agent, or Text Generator app by passing it as a positional argument to difyctl run app. The reply prints to stdout.

​
Run a Workflow

Pass the inputs as a single JSON object with --inputs instead of a positional message. The outputs print to stdout as JSON.

​
Stream a Long Response

Add --stream to print the response as it’s generated instead of all at once at the end.

​
Continue a Conversation

Copy the conversation ID from the hint that follows each reply, then pass it back with --conversation to continue the same session. This applies to Chatbot, Chatflow, and Agent apps; Workflow and Text Generator apps don’t maintain conversation state.

​
Get JSON Output for Scripts

Add -o json to any command to get the raw response as pipe-friendly JSON.