Skip to content
TestsigmaDOCS

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 theAuthorization 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()
RESPONSE200 OK
{
  "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"
}