Skip to content
You're viewing the v2 docs. Looking for v1?Go to v1 docs
Docs
Testsigma
Popular questions
↑↓ to navigate↵ to selectesc to close
Book a demo

Update a scheduled test plan

PUT/schedule_executions/{scheduleId}
Base URL https://app.testsigma.com/api/v1Region

Update an existing test plan schedule using the REST API.

Authenticate with your API key as a Bearer token in the Authorization header. How to authenticate →
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"
}

Was this page helpful?