Get API key metadata API Reference

GET

/tenants/{tenant}/apikeys/{id}

Retrieve metadata for an API key (id, displayName, role, expiresAt, status). The raw kupe_… key value is never returned by this endpoint — that value is only available in the CreateAPIKey response. Admin only.

Authorizations

• BearerAuth

Parameters

Path Parameters

tenant

required

string

Tenant name

id

required

string

API key ID (ak- prefix)

Responses

200

API key metadata

object

createdAt

string

Example

2026-03-15T08:00:00Z

createdBy

string

Example

alice@acme.com

displayName

string

Example

CI/CD Pipeline

expiresAt

string

Example

2027-01-01T00:00:00Z

id

string

Example

ak-a1b2c3d4

lastUsedAt

string

Example

2026-04-05T12:30:00Z

role

string

Example

admin

400

Invalid API key ID format

object

code

string

error

string

field

string

message

string

severity

string

401

Missing or invalid authentication

object

code

string

error

string

field

string

message

string

severity

string

403

Admin access required

object

code

string

error

string

field

string

message

string

severity

string

404

API key not found

object

code

string

error

string

field

string

message

string

severity

string

429

Rate limit exceeded

object

code

string

error

string

field

string

message

string

severity

string