> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flowra.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Run a workflow

> List workflows, execute one via the API, and poll the thread or execution status.

**Goal:** Start a workflow from your backend and confirm it finished.

## Prerequisites

* API key for your project — [Authentication](/authentication)
* A workflow id from the dashboard or `GET /api/v1/workflow/manager/list`

## Steps

<Steps>
  <Step title="List workflows">
    ```bash theme={null}
    curl -X GET "https://flowra.dev/api/v1/workflow/manager/list?limit=10" \
      -H "x-api-key: YOUR_API_KEY"
    ```

    Copy the id of the workflow you want to run. For agents vs static behavior, see [Workflows and agents](/guides/workflows-and-agents).
  </Step>

  <Step title="Execute">
    ```bash theme={null}
    curl -X POST "https://flowra.dev/api/v1/workflow/manager/execute/WORKFLOW_ID" \
      -H "x-api-key: YOUR_API_KEY" \
      -H "Content-Type: application/json" \
      -d '{ "input": { "message": "Run a short smoke test" } }'
    ```

    Save the returned **thread ID**.
  </Step>

  <Step title="Inspect the run">
    Use executions endpoints from [Workflows](/guides/workflows) (list/get by thread) or poll thread state via [Threads](/guides/threads). If the run pauses for approval, see [Human in the loop](/guides/human-in-the-loop).
  </Step>
</Steps>

## Verify

* Execute returns a thread id without an auth error
* Execution status reaches a terminal success (or a clear pause you can resume)

## Next

* [Connect an account](/recipes/connect-an-account)
* [Multi-tenant basics](/recipes/multi-tenant-basics)
* [API reference](/api-reference)