Update Model Access

PUT /integrations/{slug}/models

Bulk update integration models

cURL

curl --request PUT \
  --url https://api.portkey.ai/v1/integrations/{slug}/models \
  --header 'Content-Type: application/json' \
  --header 'x-portkey-api-key: <api-key>' \
  --data '
{
  "models": [
    {
      "slug": "<string>",
      "enabled": true,
      "is_custom": true,
      "is_finetune": true,
      "base_model_slug": "<string>",
      "configurations": {
        "custom_host": "<string>",
        "custom_headers": {
          "key": "<string>",
          "value": "<string>"
        }
      },
      "pricing_config": {
        "type": "static",
        "pay_as_you_go": {
          "request_token": {
            "price": 123
          },
          "response_token": {
            "price": 123
          }
        }
      }
    }
  ],
  "allow_all_models": true
}
'

200

{}

---

Portkey is now PRISMA AIRS AI Gateway. See it in action.

Contact Us

Bulk-update which models an integration can use, plus optional per-model routing and pricing.

Auto-enabling new models

auto_enable_new_models controls whether models the provider adds later are automatically enabled on this integration. It is the preferred, clearer alias for allow_all_models - both are accepted and functionally identical. If you send both, auto_enable_new_models takes precedence.

Each call also syncs the provider’s catalog - any models the integration doesn’t have yet are added. Synced models follow this flag: enabled when true, added but left disabled when false. Keep it false to curate access explicitly through the models list.

Per-model configurations

Each item in models accepts an optional configurations object:

Field	Type	Description
custom_host	string	Upstream base URL for this model. Must be a valid URL when set.
custom_headers	object	String-to-string map of headers sent with requests for this model.

Precedence

• Model-level custom_headers override integration-level custom_headers for that model.
• A request-time / header-level custom_host still takes priority over a model-level custom_host.

See Custom hosts and Custom models.

Example

curl -X PUT "https://api.portkey.ai/v1/integrations/openai-prod/models" \
  -H "Content-Type: application/json" \
  -H "x-portkey-api-key: $PORTKEY_API_KEY" \
  -d '{
    "auto_enable_new_models": false,
    "models": [
      {
        "slug": "my-custom-model-v1",
        "enabled": true,
        "is_custom": true,
        "base_model_slug": "gpt-4o",
        "configurations": {
          "custom_host": "https://llm.internal.example.com/v1",
          "custom_headers": {
            "x-tenant-id": "acme-prod",
            "x-region": "us-east-1"
          }
        }
      }
    ]
  }'

custom_headers values must be strings. Nested objects or non-string values are rejected.

Authorizations

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

Path Parameters

slug · string · required

Body

application/json

models · object[] · required

Show child attributes

allow_all_models · boolean

Whether to allow all models by default

Response

200 - application/json

Models updated successfully

The response is of type object.