PUT api/Timetables
Update a Timetable
Request Information
URI Parameters
None.
Body Parameters
The Timetable to be updated
Update_Timetable| Name | Description | Type | Additional information |
|---|---|---|---|
| ID |
The Timetable ID |
integer |
None. |
| Name |
The name of the Timetable |
string |
None. |
| Description |
Description of the Timetable |
string |
None. |
| Enable |
Whether or not this is enabled |
boolean |
None. |
| Time |
Time for the Timetable to take effect, in UTC |
time interval |
None. |
| IntervalType |
Interval Type, i.e. Daily, Weekly, etc |
TimetableIntervalType |
None. |
| IntervalTypeName |
Name of the Interval Type, i.e. Daily, Weekly, etc |
string |
None. |
| IntervalSetting1 |
Interval Setting 1, usage dependent on the Interval Type. If the IntervalType is set to Daily, this indicates the recurrence period. i.e. recur every n days. If the IntervalType is set to Weekly, this indicates the recurrence period. i.e. recur every n weeks. If the IntervalType is set to Monthly, this is a bitfield indicating the months to run on, where Bit 0 is January and Bit 11 is December. i.e. setting this to 2987 (0b101110100010) indicates Feb/June/Aug/Sep/Oct/Dec. |
integer |
None. |
| IntervalSetting2 |
Interval Setting 2, usage dependent on the Interval Type. If the IntervalType is set to Daily, this is not currently used. If the IntervalType is set to Weekly, this is a bitfield indicating the Days of the Week to run on, where Bit 0 is Sunday and Bit 6 is Saturday. i.e. setting this to 62 (0b0111110) indicates Mon-Fri. If the IntervalType is set to Monthly, this is a bitfield indicating the Days of the Month to run on, where Bit 0 is the 1st and Bit 30 is the 31st. i.e. setting this to 15790320 (0b00000000111100001111000011110000) indicates 5-8, 13-16, 21-24. |
integer |
None. |
| Repeat |
Whether or not to repeat the timetable. If used, values must be provided for RepeatEvery and RepeatDuration |
boolean |
None. |
| RepeatEvery |
Number of minutes between each repeat |
integer |
None. |
| RepeatDuration |
Number of minutes to indicate the maximum amount of time to continue repeating the timetable for |
integer |
None. |
| OwnerID |
The integer ID of the Owner of this Timetable |
integer |
None. |
| OwnerType |
The type for the Owner of this Timetable |
OwnerType |
None. |
| LastInterval |
The last Date/Time for the last recur interval |
date |
None. |
| LastRun |
The last Date/Time that this timetable was run, indicating the last interval or the last repeat |
date |
None. |
| NextInterval |
The Date/Time for the next recur interval |
date |
None. |
| NextRun |
The Date/Time for the next run, either on an interval or a repeat |
date |
None. |
| ApprovalPeriod |
The period for approving the Timetable's target before it starts |
time interval |
None. |
| TargetID |
The Integer ID of the object that is acted upon in this Entry |
integer |
None. |
| TargetType |
The Type of target this is for, i.e. Program or Schedule. Schedule will be removed from this list once Programs are officially introduced. |
TimetableTargetType |
None. |
Request Formats
application/json, text/json, text/html
{
"ID": 4,
"Name": "sample string 5",
"Description": "sample string 6",
"Enable": true,
"Time": "00:00:00.1234567",
"IntervalType": 0,
"IntervalTypeName": "Daily",
"IntervalSetting1": 1,
"IntervalSetting2": 1,
"Repeat": true,
"RepeatEvery": 1,
"RepeatDuration": 1,
"OwnerID": 1,
"OwnerType": 10,
"LastInterval": "2026-08-24T17:03:35.3903951+10:00",
"LastRun": "2026-08-24T17:03:35.3903951+10:00",
"NextInterval": "2026-08-24T17:03:35.3903951+10:00",
"NextRun": "2026-08-24T17:03:35.3903951+10:00",
"ApprovalPeriod": "00:00:00.1234567",
"TargetID": 1,
"TargetType": 0
}
application/x-www-form-urlencoded
Response Information
Resource Description
Returns the updated timetable and messages
GetTimetablesResponse| Name | Description | Type | Additional information |
|---|---|---|---|
| Timetables |
Array of Timetables |
Collection of Timetable |
None. |
| Messages |
Array of messages |
Collection of Message |
None. |
| ServerInformation |
Relevant information regarding the Server |
ServerInformation |
None. |
| VersionInformation |
Relevant information regarding the API's version |
VersionInformation |
None. |
Response Formats
application/json, text/json, text/html
{
"Timetables": [
{
"ID": 1,
"Name": "sample string 2",
"Description": "sample string 3",
"Enable": true,
"Valid": true,
"Time": "00:00:00.1234567",
"IntervalType": 0,
"IntervalTypeName": "Daily",
"IntervalSetting1": 1,
"IntervalSetting2": 1,
"Repeat": true,
"RepeatEvery": 1,
"RepeatDuration": 1,
"OwnerID": 1,
"OwnerType": 10,
"OwnerName": "sample string 5",
"LastInterval": "2026-08-24T17:03:35.4214298+10:00",
"LastRun": "2026-08-24T17:03:35.4214298+10:00",
"NextInterval": "2026-08-24T17:03:35.4214298+10:00",
"NextRun": "2026-08-24T17:03:35.4214298+10:00",
"ApprovalPeriod": "00:00:00.1234567",
"TargetID": 1,
"TargetType": 0,
"TargetTypeName": "SchedulingParent",
"TargetName": "sample string 6"
},
{
"ID": 1,
"Name": "sample string 2",
"Description": "sample string 3",
"Enable": true,
"Valid": true,
"Time": "00:00:00.1234567",
"IntervalType": 0,
"IntervalTypeName": "Daily",
"IntervalSetting1": 1,
"IntervalSetting2": 1,
"Repeat": true,
"RepeatEvery": 1,
"RepeatDuration": 1,
"OwnerID": 1,
"OwnerType": 10,
"OwnerName": "sample string 5",
"LastInterval": "2026-08-24T17:03:35.4214298+10:00",
"LastRun": "2026-08-24T17:03:35.4214298+10:00",
"NextInterval": "2026-08-24T17:03:35.4214298+10:00",
"NextRun": "2026-08-24T17:03:35.4214298+10:00",
"ApprovalPeriod": "00:00:00.1234567",
"TargetID": 1,
"TargetType": 0,
"TargetTypeName": "SchedulingParent",
"TargetName": "sample string 6"
}
],
"Messages": [
{
"Severity": 0,
"MessageCode": 1,
"CodeDesc": 2,
"MessageText": "sample string 3",
"RecordNumber": 4
},
{
"Severity": 0,
"MessageCode": 1,
"CodeDesc": 2,
"MessageText": "sample string 3",
"RecordNumber": 4
}
],
"ServerInformation": {
"CurrentTimeUTC": "2026-08-24T17:03:35.4214298+10:00",
"BuildDateUTC": "2026-08-24T17:03:35.4214298+10:00"
},
"VersionInformation": {
"Major": 1,
"Minor": 8,
"Hotfix": 0,
"Beta": true,
"Version": "1.8.0.BETA"
}
}