GET /keys/
Get a list of your API keys, with optional filtering and sorting.
GET /keys/ — page
A page number within the paginated result set.
GET /keys/ — page_size
Number of results to return per page.
GET /keys/ — permission
Filter for keys with grants of the given permission.
GET /keys/ — target_id
Filter for keys with grants of the given type-specific ID.
GET /keys/ — target_type
Filter for keys with grants for the given target type.
GET /api/v2/keys/
Get a list of your API keys, with optional filtering and sorting.
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
Query Parameters
page
A page number within the paginated result set.
Type
integer
page_size
Number of results to return per page.
Type
integer
permission
Filter for keys with grants of the given permission.
Type
string
target_id
Filter for keys with grants of the given type-specific ID.
Type
string
target_type
Filter for keys with grants for the given target type.
Type
string
Responses
Responses
application/json
count
integer
Required
next
string
Format
"uri"previous
string
Format
"uri"results
object[]
Required
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