Revoke
Stops the key working. Revocation is soft: the key stays listed with a
revoked_at, because the organization still owns whatever it did while
it was alive.
Authorization
BearerAuth apikeys.manageAuthorization: Bearer <key>, with a key from the console. Keys are
default-deny: each operation names the scope it needs, and an existing
key does not gain an operation until that scope is added to it.
In: header
Scope: apikeys.manage
Path Parameters
The key's id, as returned by the list endpoint. Never the key itself.
uuidResponse Body
application/json
application/json
application/json
application/json
curl -X POST "https://internetdata.io/api/v1/iam/apikeys/497f6eca-6276-4993-bfeb-53cbbbba6f08/revoke"{
"rc": "string"
}{
"rc": "string"
}{
"rc": "string"
}{
"rc": "string"
}Rotate POST
Replaces the secret behind a key, keeping its id, name and settings. The previous secret stops working immediately.
Reveal POST
Returns an existing key's secret. Its own scope rather than part of `apikeys.manage`, because the two are different acts: rotating replaces a secret you never see, while this hands one over. Refused with `NOT_RETRIEVABLE` for a key issued before this product stored secrets recoverably - that secret was never kept, so no retry will ever produce it. Rotate the key instead.