---
title: "Set or update a Codeless test schedule"
method: POST
path: "/v1/lab/{id}/schedule"
tags: ["Codeless tests"]
---

# Set or update a Codeless test schedule

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

Schedules a Codeless test to run on a recurring interval. Choose between once / daily / weekly presets or a raw cron expression.

## Path parameters

- `id` integer, required

## Request body

- PostV1LabIdSchedule — Set or update a Codeless test schedule
  - `type` 'once' | 'daily' | 'weekly' | 'custom' — Schedule preset; use "custom" with `cronFormat` for fine control.
  - `day` string — Date (YYYY-MM-DD) for "once" or weekday for "weekly".
  - `hour` string — Time (HH:MM) for "once", "daily", or "weekly".
  - `cronFormat` string — Raw cron expression (5-field) used when `type=custom`.

## Response `201`

Set or update a Codeless test schedule

- TestingbotEntitiesAck — Testingbot_Entities_Ack model
  - `success` boolean, required — Whether the operation succeeded.
  - `errors` object, required — Validation errors keyed by field name. Only present when `success` is false.
  - `error` string, required — Single human-readable reason, used by the older endpoints in place of `errors`. Only present when `success` is false.

## Other responses

- `400` — Missing day/hour for weekly
- `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)