Retrieve Virtual Key

GET /virtual-keys/{slug}

Python

Default

from portkey_ai import Portkey

# Initialize the Portkey client
portkey = Portkey(
    api_key="PORTKEY_API_KEY",
)

# Get a specific virtual key
virtual_key = portkey.virtual_keys.retrieve(
    slug='VIRTUAL_KEY_SLUG'
)

print(virtual_key)

200

{
  "name": "Open AI Workspace",
  "note": "randomness",
  "usage_limits": {
    "credit_limit": 10,
    "periodic_reset": "monthly",
    "alert_threshold": 8
  },
  "reset_usage": 0,
  "created_at": "2023-11-07T05:31:56Z",
  "slug": "<string>",
  "model_config": {},
  "rate_limits": [
    {
      "value": 123
    }
  ],
  "expires_at": "2023-11-07T05:31:56Z",
  "object": "virtual-key"
}

{
  "success": false,
  "data": {
    "message": "Unauthorised Request"
  }
}

Authorizations

x-portkey-api-key · string · header · required

Path Parameters

slug · string · required

Response

200

application/json

Successful response

name · string

Example:

"Open AI Workspace"

note · string | null

Example:

"randomness"

status · enum<string>

Available options: active, exhausted

usage_limits · object

Show child attributes

Example:

{
  "credit_limit": 10,
  "periodic_reset": "monthly",
  "alert_threshold": 8
}

reset_usage · number | null

Example:

0

created_at · string<date-time>

slug · string

model_config · object

rate_limits · object[] | null

Show child attributes

expires_at · string<date-time>

object · enum<string>

Available options: virtual-key