Edit

Edit an existing recording schedule

This action requires a request with an active account.

Tokens

This action requires the following tokens:

  • recordschedule-write

Arguments

Required arguments are marked in bold, and optional arguments are marked in italics.

Argument Type Default Description
recordschedule Hash   The ID of the record schedule to edit
source URL   Source live stream URL for this recording schedule
sourceproxy URL   Source proxy for this recording schedule; used when connecting to source
livestream Hash   If given, hash of the livestream to record
title String  

Title used for the items that are created after each recording. Can use strftime format strings

This argument can be unset by providing an empty string

description String  

Description for items that are created after recording

This argument can be unset by providing an empty string

author String  

Author for tems that are created after recording

This argument can be unset by providing an empty string

copyright String  

Copyright for tems that are created after recording

This argument can be unset by providing an empty string

keywords String  

Keywords for tems that are created after recording; separate by a comma

This argument can be unset by providing an empty string

active Boolean   Whether the schedule should be active
protected Boolean   Whether items created with this task will be protected
startdate DateTime   Date and time to start the recording. If the start date has already passed or is within a short time of now, the recording will be started as soon as possible, but it can still take up to 15 minutes before the recording starts.
duration Duration   Duration of each item in this schedule
rrule String   iCal RRULE for repeating recordings. Format follows RRULE definition as specified by RFC 5545. See http://tools.ietf.org/html/rfc5545 (chapter 3.3.10 and 3.8.5.3) for format and examples. “RRULE:” should not be provided. If this argument is given, the other arguments relating to the schedule (all arguments below) will be ignored
frequency String  

Frequency used for this repeating recording. Either this or rrule must be set.

This argument can only contain one of the following values:

  • minutely
  • hourly
  • daily
  • weekly
  • monthly
  • yearly
count Integer  

Maximum number of times the schedule is repeated

This argument can be unset by providing an empty string

until DateTime  

Date and time until when this schedule is repeated

This argument can be unset by providing an empty string

interval Integer   Interval between two occurrences. For example, within a DAILY rule, a value of “8” means every eight days, even if for example byhour contains more than one value.
bysecond String  

Repeat on the given seconds. Comma-separated list of integers between 0 and 59. If not given, will repeat only on the second given by startdate. Note this will currently only work with daily or higher rules

This argument can be unset by providing an empty string

byminute String  

Repeat on the given minutes. Comma-separated list of integers between 0 and 59. If not given, will repeat only on the minute given by startdate. Note this will currently only work with daily or higher rules

This argument can be unset by providing an empty string

byhour String  

Repeat on the given hours. Comma-separated list of integers between 0 and 23. If not given, will repeat only on the hour given by startdate. Note this will currently only work with daily or higher rules

This argument can be unset by providing an empty string

byday String  

Repeat on the given weekdays. Comma-separated list of values in the set mo, tu, we, th, fr, sa, and su

This argument can be unset by providing an empty string

bymonthday String  

Repeat on the days of the month. Comma-separated list of integers between 10 and 31

This argument can be unset by providing an empty string

byyearday String  

Repeat on the given days of the year. Comma-separated list of integers between 1 and 366

This argument can be unset by providing an empty string

byweekno String  

Repeat on the given weeks of the year. Comma-separated list of integers between 1 and 53

This argument can be unset by providing an empty string

bymonth String  

Repeat on the given months. Comma-separated list of integers between 1 and 12

This argument can be unset by providing an empty string

bysetpos String  

Only use the given results from the occurrence set. Comma-separated list of integers between 0 and 366. Note this is currently only supported for monthly rules

This argument can be unset by providing an empty string

Output

This action produces the following output on success:

An object containing the following fields:

Name Type Description
id Hash Hash of this schedule
name String Name of this schedule
user

User who created this record schedule

The value of this field is an object containing the following fields:

Name Type Description
id Hash User ID
username String User name
account

Account of this schedule

The value of this field is an object containing the following fields:

Name Type Description
id Hash Account ID
name String Account name
source String The source of this record schedule
sourceproxy String The proxy for the source
livestream

The live stream of this record schedule

The value of this field is an object containing the following fields:

Name Type Description
id Hash Livestream ID
title String Title of the live stream
description String Description of the live stream
type Label The type of this livestream; for available livestream types, refer to the documentation of the Livestream command
title String Title for created items
description String Description for created items
author String Author for created items
copyright String Copyright for created items
keywords

Keywords for created items

The value of this field is an array containing zero or more elements, each one being one String: One keyword

categories

Categories for created items

The value of this field is an array containing zero or more elements, each one being an object containing the following fields:

Name Type Description
id Hash Category ID
name String The name of this category
protected Boolean Whether items created with this schedule will be protected
active Boolean Whether this schedule is active
startdate DateTime Start date and time for this schedule
duration Duration Duration for this schedule
datecreated DateTime When this schedule was created
datemodified DateTime When this schedule was last modified
nextstart DateTime The next time this schedule will record
laststart DateTime The last time this schedule was started
repeatschedule

Information about how this schedule will repeat

The value of this field is an object containing the following fields:

Name Type Description
frequency String The frequency of this schedule
count Integer How many times this schedule will repeat
until DateTime Until when this schedule will repeat
interval Integer The interval of this schedule
bysecond

On which seconds this schedule will repeat

The value of this field is an array containing zero or more elements, each one being one Integer: A second on which this schedule will repeat

byminute

On which minutes this schedule will repeat

The value of this field is an array containing zero or more elements, each one being one Integer: A minute on which this schedule will repeat

byhour

On which hours this schedule will repeat

The value of this field is an array containing zero or more elements, each one being one Integer: An hour on which this schedule will repeat

byday

On which days of the week this schedule will repeat

The value of this field is an array containing zero or more elements, each one being one String: A day of the week on which this schedule will repeat

bymonthday

On which days of the month this schedule will repeat

The value of this field is an array containing zero or more elements, each one being one Integer: A day of the month on which this schedule will repeat

byyearday

On which day of the year this schedule will repeat

The value of this field is an array containing zero or more elements, each one being one Integer: A day of the year on which this schedule will repeat

byweekno

On which weeks of the year this schedule will repeat

The value of this field is an array containing zero or more elements, each one being one Integer: A week of the year on which this schedule will repeat

bymonth

On which months this schedule will repeat

The value of this field is an array containing zero or more elements, each one being one Integer: A month on which this schedule will repeat

bysetpos

On which occurrences in the result set this schedule will repeat

The value of this field is an array containing zero or more elements, each one being one Integer: A occurrence in the result set on which this schedule will repeat

Errors

This action can return one of the default status codes, or one of the following status codes on error:

STATUS_SCHEDULE_NOT_FOUND (320)
If the schedule specified by “ID” can not be found