Skip to main content
POST
/
api-keys
/
{type}
/
{sub-type}
from portkey_ai import Portkey # Initialize the Portkey client portkey = Portkey( api_key="PORTKEY_API_KEY", ) # Create a new API key api_key = portkey.api_keys.create( name="API_KEY_NAME_0909", type="organisation", sub_type="service", workspace_id="WORKSPACE_ID", scopes=[ "logs.export", "logs.list", "logs.view", "configs.create", "configs.update", "configs.delete", "configs.read", "configs.list", "virtual_keys.create", "virtual_keys.update", "virtual_keys.delete", "virtual_keys.read", "virtual_keys.list", "virtual_keys.copy" ] ) print(api_key) 
{
  "id": "183f497a-2a7f-4f47-992e-26213fa863we",
  "key": "abssofjosfjs",
  "object": "api-key"
}

Documentation Index

Fetch the complete documentation index at: https://docs.portkey.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
x-portkey-api-key
string
header
required

Path Parameters

​
type
enum<string>
required
Available options:
organisation,
workspace
​
sub-type
enum<string>
required
Available options:
user,
service

Body

application/json
​
name
string
required
Example:

"Development API Key"

​
scopes
string[]
required
Example:
["completions.write"]
​
description
string
Example:

"API key for development environment"

​
organisation_id
string<uuid>

Organisation ID. Optional when calling via an org-level API key (picked from auth context).

Example:

"a1b2c3d4-e5f6-7890-abcd-ef1234567890"

​
workspace_id
string
Example:

"ws-myworkspace"

​
user_id
string<uuid>

Required when sub-type path parameter is 'user'. Not required when sub-type is 'service'.

Example:

"c3d4e5f6-a7b8-6c7d-0e1f-2a3b4c5d6e7f"

​
rate_limits
object[] | null
​
usage_limits
object
Example:
{
  "credit_limit": 10,
  "periodic_reset": "monthly",
  "alert_threshold": 8
}
​
defaults
object
​
alert_emails
string<email>[]
​
expires_at
string<date-time> | null

ISO 8601 datetime at which this key expires. Must not exceed the org/workspace maximum TTL if configured.

Example:

"2026-12-31T23:59:59Z"

​
rotation_policy
object

Automatic key rotation configuration. Requires either rotation_period or next_rotation_at.

Response

200 - application/json

OK

​
id
string<uuid>
Example:

"183f497a-2a7f-4f47-992e-26213fa863we"

​
key
string
Example:

"abssofjosfjs"

​
object
enum<string>
Available options:
api-key
Example:

"api-key"

Last modified on January 28, 2026