---
title: "Trigger Run"
method: POST
path: "/v2/jobs/{job_id}/runs"
tags: ["Jobs"]
---

# Trigger Run

`POST /v2/jobs/{job_id}/runs`

## Request

- Base URL: `https://sdk.nimbleway.com`
- URL: `https://sdk.nimbleway.com/v2/jobs/{job_id}/runs`
- Auth: HTTP bearer

## Path parameters

- `job_id` string, required

## Response `201`

Successful Response

- JobRunPublicV2: A single execution of a job.
  - `created_at` string, date-time, required: When the run was created.
  - `finished_at` string, date-time, nullable: When the run finished.
  - `id` string, required: Unique run identifier (run_<n>).
  - `input_count` integer, nullable: Number of input records processed.
  - `job_id` string, required: Identifier of the job this run belongs to.
  - `result_count` integer, nullable: Number of result records produced.
  - `started_at` string, date-time, nullable: When the run started executing.
  - `status` 'PENDING' | 'RUNNING' | 'SUCCESS' | 'FAILED' | 'CANCELLED' | 'TIMEOUT' | 'WARNING', required: Current run status.
  - `triggered_by` 'schedule' | 'manual', required: What triggered the run: 'schedule' or 'manual'.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/nimbleway/apis/nimble-sdk.md) - [All operations](https://skmtc.dev/nimbleway/apis/nimble-sdk/llms.txt) - [OpenAPI document](https://skmtc.dev/nimbleway/apis/nimble-sdk/revisions/75720b84c9d7?raw)