Create an API key
Creates an API key with a context of its own; the secret is shown only in this answer.
Authentication
AuthorizationBearer
An API key: Authorization: Bearer bl_live_….
OR
AuthorizationBearer
Blende’s apps: a sign-in JWT, sent with Blende-Context-Key.
Headers
Idempotency-Key
A unique key per call; a retry with it answers the first result.
Request
This endpoint expects an object.
name
Its label.
scopes
Its scopes.
Allowed values:
expires_at
RFC 3339: when it expires; never if absent.
Response headers
Cache-Control
Always no-store.
Allowed values:
Request-Id
The request's id.
RateLimit
The quota left in the current window.
RateLimit-Policy
The rate-limit policy in force.
Response
The new key with its secret.
id
The key’s id, e.g. bl_live_3fQ….
name
Its label.
scopes
Its scopes.
Allowed values:
created_at
RFC 3339: when it was created.
last_used_at
RFC 3339: when it was last used; null if never.
secret
The full key, shown once.
expires_at
RFC 3339: when it expires; never if absent.
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
415
Unsupported Media Type Error
429
Too Many Requests Error
500
Internal Server Error