Revoke tokens

Revokes a token, immediately disabling it.

Permissions required

update privilege on the Host Factory.

URI

DELETE /host_factory_tokens/{token}

Example with curl

Suppose you have a Host Factory Token and want to revoke it:

token="1bcarsc2bqvsxt6cnd74xem8yf15gtma71vp23y315n0z201c1jza7" curl -i --request DELETE \ --header "$(conjur authn authenticate -H)" \ https://eval.conjur.org/host_factory_tokens/$token

Request Headers

Field	Description	Example
Authorization	Conjur access token	Token token=“eyJkYX…Rhb=”

Response

Code	Description
204	The token was revoked
401	The request lacks valid authentication credentials
404	Conjur did not find the specified token

Example URI

DELETE /host_factory_tokens/1bcarsc2b…

URI Parameters

Parameter	Type	Mandatory	Description
token	String	Yes	the Host Factory Token to revoke Example: 1bcarsc2b…