GET /keys/{uuid}/
Get a single API key.
GET /keys/{uuid}/ — uuid
The first eight characters of the key's UUID.
GET /api/v2/keys/{uuid}/
Get a single API key.
Try it out
Playground
Authorization
Variables
Key
Value
Authorizations
api-key
Type
API Key (header: Authorization)
or
ripe-access
Type
API Key (cookie: crowd.token_key)
Parameters
Path Parameters
uuid*
The first eight characters of the key's UUID.
Type
Requiredstring
Responses
Responses
application/json
uuid
string
Required
String to be provided when making authenticated requests to the API, masked in the keys API output after first creation/regeneration.
url
string
Required
Format
"url"label
string
A human-readable identifier to help you organise and manage your keys
created_at
string
Required
The time when this key was created or regenerated
Format
"date-time"valid_from
string
The key will start to be usable at this time, or immediately if is omitted or null
Format
"date-time"valid_to
string
The key will stop being usable at this time, or never if is omitted or null
Format
"date-time"last_used
string
Required
The last time this key was used to authenticate with the API
Format
"date-time"enabled
boolean
Can be manually set to true or false to control whether this key is active, regardless of the valid_from and valid_to values
Default
trueis_active
boolean
Required
Whether this key is currently enabled and within its defined usability time range
is_frozen
boolean
Required
Whether this key is frozen after a long period of inactivity (unfreeze with a new secret using the regenerate flag)
grants
object[]
Grants are the permissions that are granted by this key, possibly relating to specific objects such as measurements, probes or other API keys
Collapse
permission
string
Required
Permission or action to allow with this grant
target
object
Which object (probe, measurement, etc) this grant refers to (required by some permissions, not allowed for the rest)
Collapse
type
string
Required
Type of target resource
id
string
Required
Type-specific unique identifier for the target