---
canonical_url: "https://docs.composio.dev/toolkits/dify"
markdown_url: "https://docs.composio.dev/toolkits/dify.md"
product: "platform"
version: null
last_updated: null
---

# Dify

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

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

## Tools

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `workflow_run_id` | string | Yes | Workflow run ID returned by DIFY_RUN_WORKFLOW or DIFY_LIST_WORKFLOW_RUNS. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Maximum run summaries to return in this page (1-100). |
| `status` | string ("succeeded" | "failed" | "stopped") | No | Execution status to include. |
| `keyword` | string | No | Keyword to search for in workflow run logs. |
| `next_cursor` | string | No | Continuation cursor returned by the previous call; omit for the first page. |
| `created_after` | string | No | Return runs created after this ISO 8601 timestamp. |
| `creator_email` | string | No | Limit results to runs created by this Dify account email address. |
| `created_before` | string | No | Return runs created before this ISO 8601 timestamp. |
| `end_user_session_id` | string | No | Limit results to the end-user session ID that created the run. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `user` | string | Yes | Stable end-user partition key for this run; reuse it for files and later calls tied to the same user. |
| `files` | array | No | 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 | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |