Add a device to an existing DVR

Add a device to an existing DVR

PUT /livetv/dvrs/{dvrId}/devices/{deviceId}

PlexGO

Go

package main

import(
	"context"
	"github.com/LukeHagar/plexgo/models/components"
	"github.com/LukeHagar/plexgo"
	"github.com/LukeHagar/plexgo/models/operations"
	"log"
)

func main() {
    ctx := context.Background()

    s := plexgo.New(
        plexgo.WithAccepts(components.AcceptsApplicationXML),
        plexgo.WithClientIdentifier("abc123"),
        plexgo.WithProduct("Plex for Roku"),
        plexgo.WithVersion("2.4.1"),
        plexgo.WithPlatform("Roku"),
        plexgo.WithPlatformVersion("4.3 build 1057"),
        plexgo.WithDevice("Roku 3"),
        plexgo.WithModel("4200X"),
        plexgo.WithDeviceVendor("Roku"),
        plexgo.WithDeviceName("Living Room TV"),
        plexgo.WithMarketplace("googlePlay"),
        plexgo.WithSecurity("<YOUR_API_KEY_HERE>"),
    )

    res, err := s.DVRs.AddDeviceToDVR(ctx, operations.AddDeviceToDVRRequest{
        DvrID: 334755,
        DeviceID: 852930,
    })
    if err != nil {
        log.Fatal(err)
    }
    if res.Object != nil {
        // handle response
    }
}

package hello.world;

import dev.plexapi.sdk.PlexAPI;
import dev.plexapi.sdk.models.operations.AddDeviceToDVRRequest;
import dev.plexapi.sdk.models.operations.AddDeviceToDVRResponse;
import dev.plexapi.sdk.models.shared.Accepts;
import java.lang.Exception;

public class Application {

    public static void main(String[] args) throws Exception {

        PlexAPI sdk = PlexAPI.builder()
                .accepts(Accepts.APPLICATION_XML)
                .clientIdentifier("abc123")
                .product("Plex for Roku")
                .version("2.4.1")
                .platform("Roku")
                .platformVersion("4.3 build 1057")
                .device("Roku 3")
                .model("4200X")
                .deviceVendor("Roku")
                .deviceName("Living Room TV")
                .marketplace("googlePlay")
                .token(System.getenv().getOrDefault("TOKEN", ""))
            .build();

        AddDeviceToDVRRequest req = AddDeviceToDVRRequest.builder()
                .dvrId(334755L)
                .deviceId(852930L)
                .build();

        AddDeviceToDVRResponse res = sdk.dvRs().addDeviceToDVR()
                .request(req)
                .call();

        if (res.object().isPresent()) {
            // handle response
        }
    }
}

import { PlexAPI } from "@lukehagar/plexjs";
import { Accepts } from "@lukehagar/plexjs/models/shared";

const plexAPI = new PlexAPI({
  accepts: Accepts.ApplicationXml,
  clientIdentifier: "abc123",
  product: "Plex for Roku",
  version: "2.4.1",
  platform: "Roku",
  platformVersion: "4.3 build 1057",
  device: "Roku 3",
  model: "4200X",
  deviceVendor: "Roku",
  deviceName: "Living Room TV",
  marketplace: "googlePlay",
  token: "<YOUR_API_KEY_HERE>",
});

async function run() {
  const result = await plexAPI.dvRs.addDeviceToDVR({
    dvrId: 334755,
    deviceId: 852930,
  });

  console.log(result);
}

run();

curl --request PUT \
  --url https://{IP-description}.{identifier}.plex.direct:{port}/livetv/dvrs/{dvrId}/devices/{deviceId} \
  --header 'X-Plex-Client-Identifier: <x-plex-client-identifier>' \
  --header 'X-Plex-Token: <api-key>'

import requests

url = "https://{IP-description}.{identifier}.plex.direct:{port}/livetv/dvrs/{dvrId}/devices/{deviceId}"

headers = {
    "X-Plex-Client-Identifier": "<x-plex-client-identifier>",
    "X-Plex-Token": "<api-key>"
}

response = requests.put(url, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {
    'X-Plex-Client-Identifier': '<x-plex-client-identifier>',
    'X-Plex-Token': '<api-key>'
  }
};

fetch('https://{IP-description}.{identifier}.plex.direct:{port}/livetv/dvrs/{dvrId}/devices/{deviceId}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_PORT => "62437",
  CURLOPT_URL => "https://{IP-description}.{identifier}.plex.direct:{port}/livetv/dvrs/{dvrId}/devices/{deviceId}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_HTTPHEADER => [
    "X-Plex-Client-Identifier: <x-plex-client-identifier>",
    "X-Plex-Token: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

require 'uri'
require 'net/http'

url = URI("https://{IP-description}.{identifier}.plex.direct:{port}/livetv/dvrs/{dvrId}/devices/{deviceId}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["X-Plex-Client-Identifier"] = '<x-plex-client-identifier>'
request["X-Plex-Token"] = '<api-key>'

response = http.request(request)
puts response.read_body

200

{
  "MediaContainer": {
    "MediaContainer": {
      "identifier": "<string>",
      "offset": 123,
      "size": 123,
      "totalSize": 123,
      "status": 123
    },
    "DVR": [
      {
        "Device": [
          {
            "ChannelMapping": [
              {
                "channelKey": "<string>",
                "deviceIdentifier": "<string>",
                "enabled": "<string>",
                "lineupIdentifier": "<string>"
              }
            ],
            "key": "<string>",
            "lastSeenAt": 123,
            "make": "<string>",
            "model": "<string>",
            "modelNumber": "<string>",
            "protocol": "<string>",
            "sources": "<string>",
            "state": "<string>",
            "status": "<string>",
            "tuners": "<string>",
            "uri": "<string>",
            "uuid": "<string>"
          }
        ],
        "key": "<string>",
        "language": "<string>",
        "lineup": "<string>",
        "uuid": "<string>"
      }
    ]
  }
}

Authorizations

X-Plex-Token · string · header · required

The token which identifies the user accessing the PMS. This can be either:

• A traditional access token obtained from plex.tv
• A JWT token obtained through the JWT authentication flow

JWT tokens provide better security with:

• Short-lived tokens (7 days expiration)
• Public-key cryptography (ED25519)
• Better clock synchronization
• Individual device revocation capability

Headers

accepts · enum<string> · default: application/xml

Indicates the client accepts the indicated media types

Available options: application/json, application/xml

X-Plex-Client-Identifier · string · required

An opaque identifier unique to the client

Example:

"abc123"

X-Plex-Product · string

The name of the client product

Example:

"Plex for Roku"

X-Plex-Version · string

The version of the client application

Example:

"2.4.1"

X-Plex-Platform · string

The platform of the client

Example:

"Roku"

X-Plex-Platform-Version · string

The version of the platform

Example:

"4.3 build 1057"

X-Plex-Device · string

A relatively friendly name for the client device

Example:

"Roku 3"

X-Plex-Model · string

A potentially less friendly identifier for the device model

Example:

"4200X"

X-Plex-Device-Vendor · string

The device vendor

Example:

"Roku"

X-Plex-Device-Name · string

A friendly name for the client

Example:

"Living Room TV"

X-Plex-Marketplace · string

The marketplace on which the client application is distributed

Example:

"googlePlay"

Path Parameters

dvrId · integer · required

The ID of the DVR.

deviceId · integer · required

The ID of the device to add.

Response

200 - application/json

OK

MediaContainer · object

Show child attributes