---
title: "Create a Codeless suite"
method: POST
path: "/v1/labsuites"
tags: ["Codeless suites"]
---

# Create a Codeless suite

`POST /v1/labsuites`

Creates a new Codeless suite. Attach Codeless tests with `POST /v1/labsuites/:id/tests` after creation.

## Request body

- PostV1Labsuites — Create a Codeless suite
  - `suite` object, required — Suite attributes.
    - `name` string, required — Suite name.
    - `cron` string — Cron expression for scheduled suite runs.
    - `screenshot` boolean — Take screenshots at every step in every test.
    - `video` boolean — Record video for tests in this suite.
    - `idletimeout` integer — Idle timeout in seconds before tests are aborted.
    - `screenresolution` string — Browser viewport for every test in the suite.

## Response `201`

Create a Codeless suite

- TestingbotEntitiesLabSuiteCreateAck — Testingbot_Entities_LabSuiteCreateAck model
  - `success` boolean, required — Whether creation succeeded.
  - `suite_id` integer, required — ID of the newly created Codeless suite. Only present when `success` is true.
  - `errors` object, required — Validation errors keyed by field name. Only present when `success` is false.

## Other responses

- `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)