Sign in
Api-key

Retrieve an existing API key by ID

get/api-key/get

Query parameters

{"stackTrail":"paths:/api-key/get:get:parameters:0:schema","oasType":"schema","type":"unknown","description":"The configuration ID to use for the API key lookup. If not provided, the default configuration will be used."}
idstring

The id of the Api Key

Response

API key retrieved successfully

idstring required

ID

namestring nullable

The name of the key

startstring nullable

Shows the first few characters of the API key, including the prefix. This allows you to show those few characters in the UI to make it easier for users to identify the API key.

prefixstring nullable

The API Key prefix. Stored as plain text.

userIdstring required

The owner of the user id

refillIntervalnumber nullable

The interval in milliseconds between refills of the remaining count. Example: 3600000 // refill every hour (3600000ms = 1h)

refillAmountnumber nullable

The amount to refill

lastRefillAtstring date-time nullable

The last refill date

enabledboolean required

Sets if key is enabled or disabled

rateLimitEnabledboolean required

Whether the key has rate limiting enabled

rateLimitTimeWindownumber nullable

The duration in milliseconds

rateLimitMaxnumber nullable

Maximum amount of requests allowed within a window

requestCountnumber required

The number of requests made within the rate limit time window

remainingnumber nullable

Remaining requests (every time api key is used this should updated and should be updated on refill as well)

lastRequeststring date-time nullable

When last request occurred

expiresAtstring date-time nullable

Expiry date of a key

createdAtstring date-time required

created at

updatedAtstring date-time required

updated at

metadataobject nullable

Extra metadata about the apiKey

permissionsstring nullable

Permissions for the api key (stored as JSON string)

Changes