> For the complete documentation index, see [llms.txt](https://developers.couchdrop.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.couchdrop.io/administration/automations/event-automations/trigger-action-workflow.md).

# Trigger action workflow

## Trigger specific action workflow.

<mark style="color:green;">`POST`</mark> `https://api.couchdrop.io/public/workflow/<workflow_id>/trigger`

#### Path Parameters

| Name         | Type   | Description |
| ------------ | ------ | ----------- |
| workflow\_id | String | Workflow ID |

#### Headers

| Name          | Type   | Description                                                                                                                                                                                        |
| ------------- | ------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Authorization | String | <p>Access token generated in the workflow settings, if required. Must be specified as a Bearer token, in the format<br>Bearer \<token><br>e.g. <br>Bearer 23ed462a-1f53-4326-b77b-58a3c94ec274</p> |

#### Request Body

| Name       | Type        | Description                                                                                                                               |
| ---------- | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------- |
| path       | String      | Path to file / folder that will be used in the action. Optional: will default to the home directory of the user who created the workflow. |
| parameters | JSON String | JSON object mapping values to custom variables configured on the workflow, if there are any. Optional.                                    |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "result": {...}
}
```

{% endtab %}

{% tab title="403: Forbidden Invalid authentication" %}

```json
{
    // Response
}
```

{% endtab %}
{% endtabs %}