POST v3/users/reset_access - Reset Token

Use this API to reset a VitalSource Bookshelf user access token, which is generated at user create. Only the issuing API key may reset an access token. To complete this request you will need the current token and the issuing API key. There is no payload, only request headers.

The workflow to change/update a user access token is as follows:

  1. Use this endpoint to reset the token
  2. Make the v3/credentials - Verify call to retrieve a new access token

Verb/URI

POST https://api.vitalsource.com/v3/users/reset_access.xml

Data Definitions

Name
Usage
Description
Data Type
Example
Required
X-VitalSource-API-Key Request header API key issued by VitalSource string

key: value

Yes 
X-VitalSource-Access-Token Request header Access token generated at user create  string

key: value

Yes

 

Request Headers

X-VitalSource-API-Key: ALLCAPSANDNUMBERS
X-VitalSource-Access-Token: lowercaseandnumbers

Response

Success and token reset is signaled with an HTTP 200 as shown below

HTTP: 200 OK

Error Codes

HTTP & Error messages 
Message
Notes
200

 

Success. Errors provided simultaneously
474

User could not be found

Access token mismatch/error

 

 

Was this article helpful?
0 out of 2 found this helpful

Comments

1 comment
  • Great!

    0
    Comment actions Permalink

Please sign in to leave a comment.