DOCS
Reference

API: Schedules

Schedules: List schedules, Create a schedule, Pause or resume a schedule, Delete a schedule.

List schedules

GET/api/v1/schedules

When tests run by themselves: every schedule in the workspace, or those of one test or project.

MCP tool: list_schedules. Works with any key.

Query
testIdstring
Only this test
projectIdstring
Only this project

Returns { schedules: [{ id, testId, days, dayOfMonth, time, timezone, enabled, nextRunAt, lastRunAt, lastJobId, lastNote, text }] }

Request
curl https://app.testsy.dev/api/v1/schedules?testId=… \
  -H "Authorization: Bearer $QA_AI_API_KEY"

Create a schedule

POST/api/v1/tests/{testId}/schedules

Run a test by itself: on chosen weekdays, or monthly on a day, at a time in a time zone. Each scheduled run counts like any other run.

MCP tool: create_schedule. Needs a key that can also create and edit tests.

Path
testIdstringrequired
Test id (t_…)
Body (JSON)
daysstring[]
Weekdays: mon … sun (default every day)
dayOfMonthnumber
Monthly instead: day 1-28
timestringrequired
Local time, HH:MM (24 h), for example 02:00
timezonestring
IANA time zone, for example Australia/Sydney (default UTC)

Returns 201 { id }

Request
curl -X POST https://app.testsy.dev/api/v1/tests/t_mvg0/schedules \
  -H "Authorization: Bearer $QA_AI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"time":"02:00"}'

Pause or resume a schedule

PATCH/api/v1/schedules/{scheduleId}

Pause or resume a schedule.

MCP tool: update_schedule. Needs a key that can also create and edit tests.

Path
scheduleIdstringrequired
Schedule id (s_…)
Body (JSON)
enabledbooleanrequired
false pauses it, true resumes it

Returns { ok: true, enabled }

Request
curl -X PATCH https://app.testsy.dev/api/v1/schedules/s_7h \
  -H "Authorization: Bearer $QA_AI_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"enabled":false}'

Delete a schedule

DELETE/api/v1/schedules/{scheduleId}

Delete a schedule.

MCP tool: delete_schedule. Needs a key that can also create and edit tests.

Path
scheduleIdstringrequired
Schedule id (s_…)

Returns { ok: true }

Request
curl -X DELETE https://app.testsy.dev/api/v1/schedules/s_7h \
  -H "Authorization: Bearer $QA_AI_API_KEY"