---
title: "Trigger a Workflow to Run"
method: POST
path: "/workflows/{id}"
---

# Trigger a Workflow to Run

`POST /workflows/{id}`

## Request

- Base URL: `https://client.apimetrics.io/api/2`
- URL: `https://client.apimetrics.io/api/2/workflows/{id}`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/apicontext/apis/api-settings/docs/workflows/:id/post~2.ts> (a function with typed inputs; its response is checked against the schema)

Use this API to run a Workflow.

## Path parameters

- `id` string, required

## Request body

- object
  - `location_id` string: Location where the API Call was made.
  - `context` string: Dictionary of variable names and their values

## Response `200`

200

- object
  - `workflow_id` string
  - `workflow_result_id` string
  - `location_id` string
  - `context` object
    - `FOO` integer
    - `BAR` string
    - `DATUM` string

## Other responses

- `400`: 400

---

[API](https://skmtc.dev/apicontext/apis/api-settings.md) - [All operations](https://skmtc.dev/apicontext/apis/api-settings/llms.txt) - [OpenAPI document](https://skmtc.dev/apicontext/apis/api-settings/revisions/2e9a62324e82?raw)