OpenTV ENTera & OpenTV Platform Documentation

Add or reset the PIN on an account – OTT

Request

To add a PIN or reset the PIN on a given account, send a PUT request to:

http://<host>:<port>/adm/v1/accounts/actions/{{accountId}}/pin

If the PIN status is LOCKED, this request resets the status to SET.

Headers

  • Content-Type: application/json

Mandatory Arguments

  • accountID

Example

A request with this payload creates or updates the requested PIN type on a given account:

{
  "type": "PinTypeLabel",
  "value": "1234"
}

Response

A successful request returns an HTTP 200 status.

A bad request returns an HTTP 400 status.

An HTTP 404 status is returned if the specified PIN type cannot be found.

Example

The payload of a response to a successful request looks like this:

{
    "matchedCount": 1,
    "modifiedCount": 1
}

See also

For full details of this API, see Account and Device Manager (ADM) API documentation.