---
title: "Create a Codeless test"
method: POST
path: "/v1/lab"
tags: ["Codeless tests"]
---

# Create a Codeless test

`POST /v1/lab`

Creates a new Codeless test. Pass `test[name]` and either `test[url]` (target URL the test visits) or `file` (Selenium IDE export to import). Optional `test[ai_prompt]` lets you describe what the AI test agent should verify in plain English.

## Request body

- PostV1Lab — Create a Codeless test
  - `test` object — Test attributes.
    - `name` string — Test name.
    - `url` string — Target URL to test (required if no `file` is uploaded).
    - `cron` string — Cron expression for scheduled runs.
    - `screenshot` boolean — Take screenshots at every step.
    - `video` boolean — Record a video of the test.
    - `idletimeout` integer — Seconds of idle time before the runner aborts the test.
    - `screenresolution` string — Browser viewport (e.g. "1920x1080").
    - `ai_prompt` string — Plain-English instruction for the AI test agent.
  - `file` unknown

## Response `201`

Create a Codeless test

- TestingbotEntitiesLabCreateAck — Testingbot_Entities_LabCreateAck model
  - `success` boolean, required — Whether creation succeeded.
  - `lab_test_id` integer, required — ID of the newly created Codeless test.

## Other responses

- `400` — Validation error
- `401` — Authentication required
- `403` — Account is read-only

---

[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/eff607a49246/schema)