v1

latestOpenAPI 3.1.0AGPL-3.02026-07-17644498.1 KB

Jobs

Run a job immediately

Execute a job immediately by providing its ID. The job's configured tests will be run. For k6 jobs, an optional location can target an enabled location code or global for unrestricted any-worker routing.

post/api/jobs/run

Request body

jobIdstring uuid required

ID of the job to run

trigger'manual' | 'remote' | 'schedule' required

Requested trigger source. CLI-authenticated calls are normalized to remote by the server.

locationstring

Optional execution location for k6 jobs. Use an enabled location code (for example us-east) or global for unrestricted any-worker routing. global is rejected when project location restrictions are enabled.

Response

Job started

runIdstring uuid

jobIdstring uuid

statusstring

messagestring