---
title: "Run a specific Codeless test"
method: POST
path: "/v1/lab/{id}/trigger"
tags: ["Codeless tests"]
---

# Run a specific Codeless test

`POST /v1/lab/{id}/trigger`

Triggers an immediate run of a Codeless test on the browsers configured for it. Returns a `job_id` you can poll with `GET /v1/jobs/:id`.

## Path parameters

- `id` integer, required

## Request body

- PostV1LabIdTrigger — Run a specific Codeless test
  - `url` string — Override the test's base URL for this run only.

## Response `201`

Run a specific Codeless test

- TestingbotEntitiesLabRunAck — Testingbot_Entities_LabRunAck model
  - `success` boolean, required — Whether the run was queued successfully.
  - `job_id` integer, required — Job ID — poll `GET /v1/jobs/:id` for progress.

## Other responses

- `401` — Authentication required
- `402` — Insufficient credits
- `403` — Account is read-only
- `404` — Test not found

---

[API](https://skmtc.net/testingbot/apis/testingbot-rest-api.md) · [All operations](https://skmtc.net/testingbot/apis/testingbot-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/testingbot/testingbot-rest-api/versions/8f493cca8f92/schema)