Skip to main content
POST
/
tyk
/
keys
/
{keyID}
Create custom key / Import key
curl --request POST \
  --url https://{tenant}/tyk/keys/{keyID} \
  --header 'Content-Type: application/json' \
  --header 'X-Tyk-Authorization: <api-key>' \
  --data '{
  "access_rights": {
    "itachi-api": {
      "allowed_urls": [
        {
          "methods": [
            "GET"
          ],
          "url": "/users"
        }
      ],
      "api_id": "8ddd91f3cda9453442c477b06c4e2da4",
      "api_name": "Itachi api",
      "limit": {
        "per": 60,
        "quota_max": 10000,
        "quota_remaining": 10000,
        "quota_renewal_rate": 3600,
        "rate": 1000,
        "throttle_interval": 10,
        "throttle_retry_limit": 10
      },
      "versions": [
        "Default"
      ]
    }
  },
  "alias": "portal-key",
  "allowance": 1000,
  "apply_policies": [
    "5ead7120575961000181867e"
  ],
  "date_created": "2024-08-09T14:40:34.87614+03:00",
  "enable_detailed_recording": true,
  "last_updated": "1723203634",
  "meta_data": {
    "new-update-key-sample": "update-key-sample",
    "tyk_developer_id": "62b3fb9a1d5e4f00017226f5",
    "update": "sample policy update",
    "user_type": "mobile_user"
  },
  "org_id": "5e9d9544a1dcd60001d0ed20",
  "per": 60,
  "quota_max": 10000,
  "quota_renewal_rate": 3600,
  "quota_renews": 1723207234,
  "rate": 1000,
  "tags": [
    "security",
    "edge",
    "edge-eu"
  ],
  "throttle_interval": 10,
  "throttle_retry_limit": 10
}'
{
  "action": "added",
  "key": "5e9d9544a1dcd60001d0ed20customKey",
  "status": "ok"
}

Authorizations

​
X-Tyk-Authorization
string
header
required

Path Parameters

​
keyID
string
required

Query Parameters

​
suppress_reset
enum<string>
Available options:
1
​
hashed
boolean

Body

application/json
​
access_rights
object | null
​
alias
string
Example:
​
allowance
number
Example:
​
apply_policies
string[] | null
Example:
​
apply_policy_id
string
deprecated
Example:
​
basic_auth_data
object
​
certificate
string
​
data_expires
integer
Example:
​
date_created
string<date-time>
Example:
​
enable_detail_recording
boolean
deprecated
Example:
​
enable_detailed_recording
boolean
Example:
​
enable_http_signature_validation
boolean
Example:
​
expires
integer
Example:
​
hmac_enabled
boolean
Example:
​
hmac_string
string
​
id_extractor_deadline
integer
​
is_inactive
boolean
Example:
​
jwt_data
object
​
last_check
integer
Example:
​
last_updated
string
Example:
​
max_query_depth
integer
Example:
​
meta_data
object | null
Example:
​
monitor
object
​
oauth_client_id
string
​
oauth_keys
object | null
​
org_id
string
Example:
​
per
number
Example:
​
quota_max
integer
Example:
​
quota_remaining
integer
Example:
​
quota_renewal_rate
integer
Example:
​
quota_renews
integer
Example:
​
rate
number
Example:
​
rsa_certificate_id
string
​
session_lifetime
integer
Example:
​
smoothing
object | null
​
tags
string[] | null
Example:
​
throttle_interval
number
Example:
​
throttle_retry_limit
integer
Example:

Response

​
action
string
Example:
​
key
string
Example:
​
key_hash
string
​
status
string
Example: