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

Retire the current host allocation before the network opens, for an image change or a recorded compromise

Only the event’s system key, which the Athena organizer panel holds, may call this. An organizer API key is refused with 403; use the panel.

POST/api/admin/host/reallocation
Authorization
AuthorizationBearer token · headerrequired
Request body
requiredapplication/json
operationIdstringrequired
min length 1 · max length 64
allocationOperationIdstringrequired
min length 1 · max length 64
reasonstringrequired
Allowed:image_changecompromise
Responses
200

Success

Any of:
object
kindstringrequired
object
kindstringrequired
retiringstringrequired
revokedGenerationnumberrequired
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/reallocation' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "operationId": "string",
  "allocationOperationId": "string",
  "reason": "image_change"
}'
Response
{
  "kind": "unchanged"
}