---
title: "Trigger job execution"
method: POST
path: "/api/jobs/{id}/trigger"
tags: ["Jobs"]
---

# Trigger job execution

`POST /api/jobs/{id}/trigger`

Trigger a job run using a job-scoped trigger key in the `Authorization: Bearer <trigger-key>` header. For k6 jobs, an optional `location` query parameter can target an enabled location code or `global` for unrestricted any-worker routing.

## Query parameters

- `location` string

## Response `200`

Job triggered

- JobTriggerResponse
  - `success` boolean
  - `message` string
  - `data` JobTriggerResponseData
    - `jobId` string, uuid
    - `jobName` string
    - `runId` string, uuid
    - `status` 'queued' | 'running'
    - `position` integer, nullable
    - `testCount` integer
    - `triggeredBy` string
    - `triggeredAt` string, date-time

## Other responses

- `400` — Invalid job ID, invalid location, or the job cannot be triggered
- `401` — Authentication required or token invalid
- `402` — Active subscription required
- `403` — Insufficient permissions
- `404` — Resource not found
- `429` — Rate limited — too many trigger requests

## Changes

> 4 revisions in range; 1 could not be searched.

- **2026-03-21** `40aeed2ccba7` — 1 warning, 6 info
  - removed the optional property `runId` from the response with the `200` status
  - added the new optional `query` request parameter `location`
  - added the non-success response with the status `400`
  - added the non-success response with the status `402`
  - …3 more
- **2026-02-08** `78bbac89339b` — 3 warning, 4 info
  - deleted the `query` request parameter `location`
  - removed the optional property `data` from the response with the `200` status
  - removed the optional property `success` from the response with the `200` status
  - removed the non-success response with the status `400`
  - …3 more

[Change history](https://skmtc.dev/supercheck-io/apis/supercheck-api/changes/api/jobs/:id/trigger/post.md)

---

[API](https://skmtc.dev/supercheck-io/apis/supercheck-api.md) · [All operations](https://skmtc.dev/supercheck-io/apis/supercheck-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/supercheck-io/supercheck-api/revisions/81782deccf0e/schema)