Skip to content

Get the calling key

GET
/v1/keys/self
curl --request GET \
--url https://api.roundrobinbot.eu/v1/keys/self \
--header 'Authorization: Bearer <token>'

Answers with the key’s scopes, the rotations it may reach, and who owns it. Never with the secret, which exists only in your hands: a lost secret is replaced, not recovered.

OK

Media typeapplication/json

An API key: what it may do, what it may reach, and who owns it. Never the secret, which exists only in your hands once the key has been created.

object
id
string
name
string
teamId
string
scopes
Array<string>
selector

Either AllRotations or Rotations.

string
rotationIds

Empty when the selector covers every rotation.

Array<string>
apiVersion
string
createdAt

When the key was created.

string format: date-time
Examplegenerated
{
"id": "example",
"name": "example",
"teamId": "example",
"scopes": [
"example"
],
"selector": "example",
"rotationIds": [
"example"
],
"apiVersion": "example",
"createdAt": "2026-04-15T12:00:00Z"
}

Unauthorized

Media typeapplication/json
object
type
null | string
title
null | string
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
detail
null | string
instance
null | string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}

Forbidden

Media typeapplication/json
object
type
null | string
title
null | string
status
null | integer | string format: int32
/^-?(?:0|[1-9]\d*)$/
detail
null | string
instance
null | string
Examplegenerated
{
"type": "example",
"title": "example",
"status": 1,
"detail": "example",
"instance": "example"
}