Skip to content
Testsigma DOCS

Update a scheduled test plan

PUT/schedule_executions/{scheduleId}

Base URL  https://app.testsigma.com/api/v1

Update an existing test plan schedule using the REST API.

Authenticate with your API key as a Bearer token in the Authorization header. Generate a key →
scheduleIdThe ID of the required schedule of the selected plan.
nameThe name you want to give to the test schedule.
executionIdTest plan ID from the GET API.
scheduleTypeHow frequently you want to run tests — ONCE, HOURLY, DAILY, WEEKLY, MONTHLY.
statusStatus of the schedule, e.g. ACTIVE.
nextIntervalDate and time (yyyy-MM-dd'T'HH:mm:ss.SSS) to trigger the test plan.
timezoneThe timezone you want to follow.
idThe ID of the schedule.
executionIdTest plan ID from the GET API.
nameThe name given to the test schedule.
commentsComments on the schedule.
scheduleTypeHow frequently tests run — ONCE, HOURLY, DAILY, WEEKLY, MONTHLY.
nextIntervalEpoch timestamp of the next trigger interval.
nextIntervalUTCNext trigger interval in UTC.
createdByIdThe user ID of the creator.
createdDateDate when the schedule was created.
updatedByIdThe user ID of the updater.
updatedDateDate when the schedule was updated.
statusStatus of the schedule.
REQUEST
curl -X PUT \
  'https://app.testsigma.com/api/v1/schedule_executions/{scheduleId}' \
  -H 'Authorization: Bearer <API_KEY>' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "Updated schedule",
    "executionId": 180,
    "scheduleType": "WEEKLY",
    "status": "ACTIVE",
    "nextInterval": "2022-12-20T15:28:00.000",
    "timezone": "PST"
  }'
const response = await fetch('https://app.testsigma.com/api/v1/schedule_executions/{scheduleId}', {
  method: 'PUT',
  headers: {
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
      "name": "Updated schedule",
      "executionId": 180,
      "scheduleType": "WEEKLY",
      "status": "ACTIVE",
      "nextInterval": "2022-12-20T15:28:00.000",
      "timezone": "PST"
  })
});
const data = await response.json();
import requests

response = requests.put(
  'https://app.testsigma.com/api/v1/schedule_executions/{scheduleId}',
  headers={
    'Authorization': 'Bearer <API_KEY>',
    'Content-Type': 'application/json'
  },
  json={
      "name": "Updated schedule",
      "executionId": 180,
      "scheduleType": "WEEKLY",
      "status": "ACTIVE",
      "nextInterval": "2022-12-20T15:28:00.000",
      "timezone": "PST"
  }
)
data = response.json()
RESPONSE200OK
{
  "id": 16,
  "executionId": 180,
  "name": "Updated schedule",
  "comments": null,
  "scheduleType": "WEEKLY",
  "nextInterval": 1671578880000,
  "nextIntervalUTC": "2022-12-20T23:28:00Z",
  "createdById": 9,
  "createdDate": 1670995456000,
  "updatedById": 10,
  "updatedDate": 1671548631732,
  "status": "ACTIVE"
}