---
title: "Create run"
method: POST
path: "/runs"
tags: ["Runs"]
---

# Create run

`POST /runs`

## Request

- Base URL: `https://localhost:8446/api/v2`
- URL: `https://localhost:8446/api/v2/runs`
- Auth: API key in header `Authorization`

Creates job run

## Request body

- object
  - `job_id` number, required: Job id
  - `agents` number: List of Agents to run on. Only available if run type is run. Must not be specified for dry_run. If specified must not be empty. If not specified, job will be run on all Agents.
  - `run_type` string: Run type. run - available for all types of jobs dry_run - available only for storage_tiering_and_archival. This type of run does not support List of agents.

## Response `200`

Successful response

- object

## Other responses

- `default`: Error response. Depending on the error, either a 4xx or 5xx response status is returned.

---

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