Update Integration

PUT /integrations/{slug}

Python

Default

from portkey_ai import Portkey # Initialize the Portkey client portkey = Portkey( api_key="PORTKEY_API_KEY", ) # Update a specific integration integration = portkey.integrations.update( slug="INTEGRATION_SLUG', name="updated-name", note="hello" ) print(integration)

200

{}

---

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

Contact Us

Authorizations

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

Path Parameters

slug · string · required

Body

application/json

name · string

Human-readable name for the integration

Example:

"Production OpenAI"

key · string

API key for the provider (if required)

Example:

"sk-..."

description · string

Optional description of the integration

Example:

"Production OpenAI integration for customer-facing applications"

configurations · OpenAI · object

Configuration for OpenAI integrations. Supports three authentication modes selected via provider_auth_type:

• apiKey (default) – standard API-key auth; no extra fields required.
• oauthClientCredentials – Portkey obtains an access token from your IdP using the OAuth 2.0 client-credentials grant and forwards it to OpenAI.
• wif (Workload Identity Federation) – Portkey mints a subject JWT via your configured IdP and exchanges it at OpenAI's WIF token endpoint.

OpenAI

Anthropic

Azure OpenAI

AWS Bedrock

Vertex AI

Azure AI

Workers AI

AWS Sagemaker

Hugginface

Cortex

Custom Base URL

Show child attributes

secret_mappings · object[]

Dynamically resolve secrets from secret references at runtime. Valid target_field values are "key" or "configurations." (e.g. "configurations.aws_secret_access_key", "configurations.azure_entra_client_secret"). Each target_field must be unique.

Show child attributes

pricing_adjustments · object | null

Per-Integration pricing adjustments applied on top of Portkey's base model pricing for cost tracking, analytics, and budget limits. Use to reflect negotiated discounts, committed-use rates, or internal markups for cost showback.

Show child attributes

Example:

{
  "multiplier": {
    "default": 0.8,
    "cache_read_input_token": 0.9,
    "cache_write_input_token": 0.9
  }
}

Response

200 - application/json

Successful response

The response is of type object.