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…