> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Dify

> Run and inspect a published Dify Workflow app through its Service API, including configuration and workflow run history.

![Dify logo](https://mintcdn.com/composio-preview/VNLruGH5mLZqXdPH/images/toolkits/dify.svg?fit=max\&auto=format\&n=VNLruGH5mLZqXdPH\&q=85\&s=c251f30a6c62647ffbf728570ae2fab1)

* **Category:** ai agents
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 4
* **Triggers:** 0
* **Slug:** `DIFY`
* **Version:** 20261030\_00

## Tools

> [accordion] Get Workflow App Configuration
>
> **Slug:** `DIFY_GET_WORKFLOW_APP_CONFIGURATION`
>
> Return the connected Workflow app's identity, declared input form and upload limits, tool icons, and hosted-site settings. If the app is unpublished, the response identifies the unavailable parameters section while preserving the other metadata.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Workflow Run
>
> **Slug:** `DIFY_GET_WORKFLOW_RUN`
>
> Return one workflow run's status, inputs, arbitrary outputs, error, and execution metrics by run ID.
>
> #### Input Parameters
>
> **workflow\_run\_id** `string` *required*
>
> Workflow run ID returned by DIFY\_RUN\_WORKFLOW or DIFY\_LIST\_WORKFLOW\_RUNS.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Workflow Runs
>
> **Slug:** `DIFY_LIST_WORKFLOW_RUNS`
>
> Return one page of run summaries for the connected Workflow app, with filters and a continuation cursor for older or additional runs.
>
> #### Input Parameters
>
> **limit** `integer`
>
> Maximum run summaries to return in this page (1-100).
>
> **status** `string ("succeeded" | "failed" | "stopped")`
>
> Execution status to include.
>
> **keyword** `string`
>
> Keyword to search for in workflow run logs.
>
> **next\_cursor** `string`
>
> Continuation cursor returned by the previous call; omit for the first page.
>
> **created\_after** `string`
>
> Return runs created after this ISO 8601 timestamp.
>
> **creator\_email** `string`
>
> Limit results to runs created by this Dify account email address.
>
> **created\_before** `string`
>
> Return runs created before this ISO 8601 timestamp.
>
> **end\_user\_session\_id** `string`
>
> Limit results to the end-user session ID that created the run.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Run Workflow
>
> **Slug:** `DIFY_RUN_WORKFLOW`
>
> Run the connected app's latest published workflow in blocking mode and return its app-defined outputs. Inspect the app configuration first: the configured workflow may perform irreversible external side effects.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> Stable end-user partition key for this run; reuse it for files and later calls tied to the same user.
>
> **files** `array`
>
> Optional files accepted by the app. Each needs type and transfer\_method, plus url for remote\_url or upload\_file\_id for local\_file.
>
> **inputs** `object` *required*
>
> App-specific workflow inputs keyed by variable name. Call DIFY\_GET\_WORKFLOW\_APP\_CONFIGURATION first and follow its user\_input\_form; values may be strings, numbers, booleans, objects, or file-object arrays.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
