Application DVR Settings Update

Updates the DVR (time-shift) settings for an application.

Request

Property	Value
Method	`PATCH`
URL	`/api/applications/{appName}/settings/dvr`
Content-Type	`application/json`
Authentication	Bearer Token

Path Parameters

Parameter	Type	Required	Description
`appName`	string	Yes	Application name

Request Body

Parameter	Type	Required	Description
`data.attributes.enabled`	boolean	No	Enable DVR
`data.attributes.cacheSize`	integer	No	DVR cache size in seconds

Example Request

{
  "data": {
    "attributes": {
      "enabled": true,
      "cacheSize": 250
    }
  }
}

Response

Status Codes

Code	Description
200	Success - Settings updated
400	Bad Request - Invalid parameters
401	Unauthorized - Invalid or missing token
404	Not Found - Application does not exist
429	Too Many Requests - Rate limit exceeded
500	Internal Server Error

Successful Response (200)

{
  "data": {
    "attributes": {
      "enabled": {
        "editable": true,
        "value": true
      },
      "cacheSize": {
        "editable": true,
        "value": 250
      }
    }
  },
  "meta": {
    "executionTime": 12,
    "generatedAt": 1766064601242
  },
  "message": "DVR Settings have been updated"
}

Response Body

DVR Settings

Parameter	Type	Description
`data.attributes.enabled.value`	boolean	DVR enabled status
`data.attributes.enabled.editable`	boolean	Indicates if the field can be modified
`data.attributes.enabled.lockedBy`	string	Locked by environment variable (if present)
`data.attributes.cacheSize.value`	integer	DVR cache size in seconds
`data.attributes.cacheSize.editable`	boolean	Indicates if the field can be modified
`data.attributes.cacheSize.lockedBy`	string	Locked by environment variable (if present)
`message`	string	Response status message

Metadata

Parameter	Type	Description
`meta.executionTime`	integer	Request processing time in milliseconds
`meta.generatedAt`	integer	Response generation timestamp (Unix timestamp in ms)

Error Responses

Application Not Found (404)

{
  "message": "Application not found"
}

Error Response Body

Parameter	Type	Description
`message`	string	Human-readable error message