Problem type

Playlist requires a newer API version

HTTP 409 ยท version_required

What it means

The API answers with HTTP 409 Conflict and the application/problem+json document below when the condition is Playlist requires a newer API version. The document's type member is https://screenrig.ai/problems/version-required, the address of this page, and its code member is version_required.

What to do

This playlist has ad pages, which only the playlists API (/api/playlists) accepts. Write it there, or remove the ad pages to keep using this API.

Should you retry?

The retryable member appears only on HTTP 5xx problems, so this one has none. Follow the steps under What to do before sending the request again.

Example response

Most routes answer with the error in the first entry of errors, and the document members instance and request_id beside it. The type, code, title and status of this problem type are fixed; detail varies per request, and hint is the registry default unless the handler sets a more specific one.

http
HTTP/1.1 409 Conflict
Content-Type: application/problem+json

{
  "errors": [
    {
      "status": 409,
      "code": "version_required",
      "type": "https://screenrig.ai/problems/version-required",
      "title": "Playlist requires a newer API version",
      "detail": "What went wrong in this request.",
      "hint": "This playlist has ad pages, which only the playlists API (/api/playlists) accepts. Write it there, or remove the ad pages to keep using this API."
    }
  ],
  "instance": "INSTANCE",
  "request_id": "REQUEST_ID",
  "server_time": "2026-01-01T00:00:00Z"
}

In the API contract

The OpenAPI contract describes this problem in these words:

Versioned playlist list that may expose adslot pages. The v1 list refuses a page holding an ad-bearing document with version_required instead of filtering it.

Operations that name this problem

These operations name this problem in the API reference:

Player action

This problem defines no Player action class. It belongs to a project, pairing or account flow that an agent or the dashboard drives.

Reference

Codeversion_required
HTTP status409 Conflict
Typehttps://screenrig.ai/problems/version-required
Player actionnone