VocalDocscontracts 1.65.0

ApiKey

A credential of one Organization for one environment. Vocal stores only a salt and a hash of the secret.

An object with 12 fields.

Fields

FieldTypeRequiredDescription
created_atTimestampyes
created_byActorRef or nullnoWho made the key (1.52.0): {type: member, id} for a key created through POST /v1/api-keys, {type: operator, id} for one the seed or an operator command made when the api records it, and null when it does not. Absent from an api before 1.52.0. A removed Member keeps its id here; the keys it made stay.
environmentEnvironmentyes
expires_atTimestamp or nullyes
idApiKeyIdyes
last_used_atTimestamp or nullyes
namestringyes
object"api_key"yes
prefixstringyesThe non-secret start of the key, vk_<env>_<lookup>; the full key is vk_<env>_<lookup>_<secret>.
revoked_atTimestamp or nullyes
scopesarray of ApiKeyScopeyes
statusApiKeyStatusyes

Used by

The operations whose parameters, request body or responses name this shape directly.