Get Transient Token
This API command will get a temporary token that has the same access level as the caller's token. The token returned by this request will be valid for 48 hours and are destroyed if the Plex server is restarted.
URL
GET http://[IP address]:32400/security/token?X-Plex-Token=[PlexToken]
Parameters
| Name | Description |
|---|---|
| IP address | The IP address of the Plex Media server. |
| PlexToken | The authentication Plex token. |
Return Status
| HTTP Code | Description |
|---|---|
| 200 | Success - The request was successful. |
| 401 | Unauthorized - The Plex token provided was not valid. |
Response
XML string that contains the temporary token. An example of the XML that is returned is shown below:
<?xml version="1.0" encoding="UTF-8"?> <MediaContainer size="0" token="transient-24b68e46-3eb5-449e-8295-ff59e9a5e6cb"></MediaContainer>
The XML returned is very simple and includes two attributes, with one of the attributes being the transient token.
| Attribute | Description |
|---|---|
| size | Not used. Will be 0. |
| token | The token. |
Remarks
As mentioned above, the token is temporary. It will be valid for 48 hours and is invalid once the Plex server is restarted.
The transient token will have the same access level as the Plex token used to make the request. For example, if the server token is used to make the request, then the transient token will have server-level access.
Transient tokens have the 'transient' prefix.
Examples
Example 1
Get a new transient token on the Plex Media Server located at the IP address of 192.168.1.4 that has the same access as the L6vkd7JtLHjsH5987vYY token:
GET http://192.168.1.4:32400/security/token?X-Plex-Token=L6vkd7JtLHjsH5987vYY