---
title: "Create Forge recipe run"
method: POST
path: "/forge-recipes/{forgeRecipe}/runs"
tags: ["Recipes"]
---

# Create Forge recipe run

`POST /forge-recipes/{forgeRecipe}/runs`

Run a Forge recipe on specified servers.

Processing mode: <small><code>async</code></small>

## Path parameters

- `forgeRecipe` integer, required

## Request body

- RunRecipeRequest
  - `email` boolean — Whether to send an email notification when the recipe has completed.
  - `servers` integer[], required — The servers on which to run the recipe on.

## Response `202`

Recipe run accepted

## Other responses

- `403` — Authorization error
- `404` — Not found
- `422` — Validation error

---

[API](https://skmtc.net/mfullbrook/apis/forge.md) · [All operations](https://skmtc.net/mfullbrook/apis/forge/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mfullbrook/forge/versions/24ad66d99f93/schema)