How to Remove a PIN

You can easily remove a PIN from Plex using the Web app if the user has added a PIN. You may want to remove a PIN if you no longer need it associated with an account, or find it too much issue to enter it in each time from a client.

If you would like to remove the PIN for a Plex Home user, you can use the method outlined in the next section.

How to Remove a PIN in Plex

How to remove a PIN

The following steps explain how to remove a PIN for a user in Plex.

  1. Log into your Plex server as an administrator, and then click the Settings - the wrench - link in the upper-right corner of the Plex server page.
    Plex Settings Icon.
    The 'Plex Settings' icon
  2. Click the Plex Home option from the menu on the left.
    Plex Home Option.
    The 'Plex Home' option
  3. Hover over the user whose PIN you would like to remove, and then click the Edit PIN link that appears.
    Plex Edit PIN Option.
    The 'Edit PIN' option in Plex
  4. In the Confirm Current PIN dialog, enter the current PIN of the user.
    Plex Confirm Current PIN.
    The 'Confirm Current PIN' dialog in Plex
  5. In the Edit PIN dialog, click the Remove option.
    Plex Remove PIN option.
    The 'Remove PIN' option in Plex

There is no confirmation message displayed when the PIN is removed. In the list of users listed in the Plex Home screen, you will no longer see the PIN Required next to the user.

How to remove a PIN using the API

While using the Plex Web App is the easiest way of removing a user's PIN, you can also remove a PIN using the plex.tv API.

There are a few things to note when using the API to remove a user's PIN:

  1. The Plex Authentication Token used in the request needs to be either an administrator token or a device token. A managed user token will not work, even if the PIN being removed is for the managed user.
  2. The ID associated with the user will need to be known as it will be included in the URL of the request. For managed users the ID can be found by calling the Get Accounts API. For the ID of the administrative user, it will be explained in the next section.

Any additional information for removing the PIN will be outlined in the next two sections.

Admin User

To remove the PIN from the administrative user, you will need to know the current PIN. If you don't know the current PIN, then you will need to use the Web App's PIN forgot option.

Before removing the PIN, you will also need to know the ID of the administrative user account. The easiest way to get the ID is to make an API request using the administrative token:

GET https://plex.tv/api/v2/user?X-Plex-Token={admin_plex_token}

The ID of the administrative user will be returned in the id attribute of the user element in the XML.

Now that you have the administrative ID, you can make the following request to remove the PIN for the administrative user account:

PUT https://plex.tv/api/home/users/{admin_id}?currentPin={old_pin}&pin=&X-Plex-Token={plex_token}

Once the request is made, you will get one of the following response status codes indicating the result:

API Request Return Status Codes
HTTP CodeDescription
200Success. The PIN has been removed.
401Unauthorized. The old PIN is incorrect or the token used to make the request is not authorized to remove the PIN.
404Not found. The user associated with the ID was not found. Verify the ID of the API request.

The PIN is removed by simply setting the new PIN to an empty value in the API request.

Managed User

Removing the PIN for a managed user is similar. One difference is that you don't need to know the current PIN of the user to remove it. You will also need an additional piece of information to remove the PIN: a client ID.

You can get a client ID by making a request to the Get Devices API and look for an ID in the clientIdentifier attribute.

I recommend you use an ID of a client that is further down in the list as that API request call will return all devices that have ever been authenticated with the Plex server, including devices no longer valid.

Once you have a client ID, you can use that to remove the PIN for a managed user using the following API request:

POST https://plex.tv/api/v2/home/users/restricted/3972737?X-Plex-Token={plex_token}&X-Plex-Client-Identifier={client_id}&removePin=1

Once the request is made, you will get one of the following response status codes indicating the result:

API Request Return Status Codes
HTTP CodeDescription
201Created. The PIN has been removed.
401Unauthorized. The token used to make the request is not authorized to remove the PIN.
404Not found. The user associated with the ID was not found. Verify the ID of the API request.
Subscribe
Display