...
A user can create a new recording for their profile by calling the create recording endpoint. A user may record a program if the following are true:
...
The recording may be marked as favourite on creation and it can be marked or unmarked as favourite by calling the update recording endpoint.
Individual recordings can be deleted by calling the delete recording endpoint, or in a batch of multiple recordings by calling the batch delete recordings endpoint. TODO: update the link
Streaming
If a recording is streamable, the available stream URLs can be obtained by calling the streams API with the ID of the Recording.
...
Recordings can be searched using the search recordings endpoint. If no search string is provided, then all recordings for the profile are returned.
...
Recordings are automatically grouped by series. The client can obtain a list of recording groups available to their profile by calling the recording groups endpoint.
The contents of each group can be viewed by calling the get grouped recordings endpoint. For recordings that do not belong to any group, the special ungrouped endpoint can be used. These two endpoints will always include the related broadcast slots in the response, that contain information about the contents of the recording to be shown to the user.
...
If the user wishes to have recordings created automatically for them as they become available, they can create an Automated recording request by calling the create auto recording request endpoint. Users can obtain a list of their current auto recording requests by calling the get auto recording requests endpoint. Users can update those requests by calling the update recording request endpoint, and delete them using the delete auto recording request endpoint.
If the Auto recording request has auto_delete set, the system will limit the maximum number of recordings retained based on a configurable value. The oldest of the recordings created as a result of the auto recording request will be automatically deleted as new recordings are added.
...