WoodWing Help Center

Elvis 6 REST API - revokeAuthKeys

Elvis 6 REST API - revokeAuthKeys

POST

http://yourserver.com/services/revokeAuthKeys
    ?keys=<comma-delimited list of authKeys>

What does it do?

Revoke a previously created authKey.

POST requests only

This REST API only accepts POST requests, not GET requests. Also, the POST request needs to include a cross-site request forgery (csrf) token.

The csrf token is a unique code which, by including it in the request, also makes the POST request unique and therefore much more secure.

The csrf token is obtained by first logging in to Elvis Server through a POST request. The response that is received will include the csrf token which can then be used in subsequent POST requests as a http header:

"X-CSRF-TOKEN: <some_csrf_token>"

For more information including examples, see Elvis 6 REST API - Performing a POST request with a csrf token.

Parameters

keys

Comma-delimited list of authKeys.

Required.

Return value

If the operation succeeds an empty JSON object with status 200 will be returned. If the operation fails, an error page with a 500 error status will be returned.

Examples

revokeAuthKeys

http://demo.elvisdam.com/services/createAuthKey
    ?keys=qQ-1X1b,aayy4ZE

This call revokes will revoke the authKeys "qQ-1X1b" and "aayy4ZE".

Document history

  • 27 July 2017: Added section 'Post requests only'.
Was this article helpful?
0 out of 0 found this helpful / Created: / Updated:
Have more questions? Submit a request

0 Comments

Please sign in to leave a comment.