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

Pin the event host's client certificate for 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.

PUT/api/admin/host/credential
Authorization
AuthorizationBearer token · headerrequired
Request body
requiredapplication/json
generationintegerrequired
max 9007199254740991
fingerprintstringrequired
matches ^[0-9a-f]{64}$
expiresAtstring<date-time>required
matches ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$
Responses
200

Success

generationnumberrequired
fingerprintstringrequired
expiresAtstringrequired
activatedbooleanrequired
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 PUT '/api/admin/host/credential' \
  -H 'Authorization: Bearer YOUR_TOKEN' \
  -H 'Accept: application/json' \
  -H 'Content-Type: application/json' \
  -d '{
  "generation": 1,
  "fingerprint": "string",
  "expiresAt": "2019-08-24T14:15:22Z"
}'
Response
{
  "generation": 0,
  "fingerprint": "string",
  "expiresAt": "string",
  "activated": true
}