Skip to content
Athena User Guide
Esc
↑↓navigate↵open⌘Jpreview

Revoke the event host's credential up to and including a generation

Only the Athena platform’s own keys for this event may call this, as part of provisioning its host. An organizer API key is refused with 403.

POST/api/admin/host/credential/revoke
Authorization
AuthorizationBearer token · headerrequired
Request body
requiredapplication/json
generationintegerrequired
max 9007199254740991
Responses
200

Success

revokedGenerationnumberrequired
revokedbooleanrequired
401

Unauthorized

errorstringrequired
403

Response for status 403

errorstringrequired
409

Response for status 409

errorstringrequired
422

Validation failed

typestringrequired
onstringrequired
summarystring
messagestring
foundany
propertystring
expectedstring
500

Unhandled server error

errorstringrequired
Try it
Server
Authorization
Bodyapplication/json
Request
curl -X POST '/api/admin/host/credential/revoke' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "generation": 1
}'
Response
{
  "revokedGeneration": 0,
  "revoked": true
}