VocalDocscontracts 1.65.0

ApiKeyCreated

The answer of POST /v1/api-keys (1.51.0, FR-identity-2): the fields of an ApiKey and the full key once.

An object with 13 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
secretApiKeySecret or nullyesThe full key (1.51.0), shown in this answer only and never again; null on a replay of the creation under the same Idempotency-Key, which creates nothing.
statusApiKeyStatusyes

Used by

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