# Workflow Execution API

**Description:** Initiates execution of the specified workflow.

**Try it out:** [Swagger Reference](https://arcee.portal.swaggerhub.com/orchestra/default/arcee-orchestra-v-1-0-0#/default/executeWorkflow)

### **Request Syntax:**

```json
POST /workflows/{workflow_id}/execute
Authentication: Bearer <Your API key>
Content-type: application/json

{
  "input_variable_1": "",
  "input_variable_2": ""
}
```

{% hint style="info" %}
You can get the {workflow\_id} from the workflow page.
{% endhint %}

### **Response Syntax:**

```json
{
    "message": "",
    "run_id": ""
}
```

<details>

<summary>Execute a Workflow Response Example</summary>

```json
{
    "message": "Workflow execution started",
    "run_id": "fda37c90-dd1c-4317-82d1-797b7f77fca5"
}
```

</details>

### **Response Syntax Variables**

* **Message**: Indication that the workflow execution has begun
* **Run id**: ID for this specific execution of the workflow