Create a key. Its secret is in this answer and nowhere else, ever
Store secret in a secret manager and never print it. A retry with the same Idempotency-Key returns the same key WITHOUT its secret (secret: null): if the first answer was lost, revoke that key and create another.
POST
https://api.invox.page/v1/service_accounts/{id}/keysAuthorization
Path parameters
Header parameters
Request body JSON required
- expires_atoptionalstring
When the key stops working. Omit for a key without expiry.
format: date-time · pattern: ^(?:(?:\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|([+-](?:[01]\d|2[0-3]):[0-5]\d)))$
Returns
200
A retry: the key, without its secret.
JSON
201
The key, with its secret.
JSON
400
organization_required: This credential needs to say which organization it acts on · validation_failed: The request is not valid · malformed_request: The request body is not valid JSON · idempotency_key_required: This write needs an Idempotency-Key header
JSON
401
unauthenticated: No credential was sent · invalid_credential: The credential is not valid
JSON
403
missing_scope: The credential lacks the permission this operation requires · organization_mismatch: The X-Organization header names another organization than the key's · organization_archived: The organization is archived · scope_not_grantable: A permission in the request cannot be granted
JSON
404
not_found: The resource does not exist in this organization
JSON
409
service_account_disabled: The service account is disabled · key_limit_reached: The service account already has the maximum number of keys
JSON
422
idempotency_key_reused: This Idempotency-Key was already used with a different request
JSON
429
rate_limited: Too many requests
JSON
500
internal_error: The service failed
JSON
503
service_unavailable: The service cannot answer right now
JSON