---
title: "Create an AI Gateway Model Provider"
method: POST
path: "/v1/ai-gateways/{gatewayId}/model-providers"
tags: ["AI Gateway Model Providers"]
---

# Create an AI Gateway Model Provider

`POST /v1/ai-gateways/{gatewayId}/model-providers`

**Pre-release Endpoint**
This endpoint is currently in beta and is subject to change.

Registers a new model provider for the AI Gateway.

## Request body

- union — **Pre-release Feature** This feature is currently in beta and is subject to change.
  - AIGatewayModelProviderAnthropic — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `type` 'anthropic', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - AIGatewayModelProviderAzure — **Pre-release Feature** This feature is currently in beta and is subject to change. Config for Azure model provider.
    - `type` 'azure', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required
      - `auth` union, required
        - AIGatewayModelProviderConfigAuthBasic — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
          - `type` 'basic', required
          - `headers` object[]
            - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `params` object[]
            - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
        - AIGatewayModelProviderConfigAuthAzure — **Pre-release Feature** This feature is currently in beta and is subject to change. Configuration for Azure model provider.
          - `type` 'azure', required
          - `client_id` string — If azure_use_managed_identity is set to true, and you need to use a different user-assigned identity for this LLM instance, set the client ID. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `client_secret` string — If azure_use_managed_identity is set to true, and you need to use a different user-assigned identity for this LLM instance, set the client secret. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `tenant_id` string — If azure_use_managed_identity is set to true, and you need to use a different user-assigned identity for this LLM instance, set the tenant ID. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `use_managed_identity` boolean — Set true to use the Azure Cloud Managed Identity (or user-assigned identity) to authenticate with Azure-provider models.
      - `service` 'azure-openai' | 'azure-foundry' — Selects the Azure backend for this provider instance. Use `azure-openai` for Azure OpenAI deployments or `azure-foundry` for Azure AI Foundry.
      - `instance` string — The Azure OpenAI instance name. Required when `service` is `azure-openai`.
      - `foundry` object — Endpoint configuration for Azure AI Foundry hosted models. Required when `service` is `azure-foundry`.
        - `resource` string, required — The Azure AI Foundry resource name.
        - `domain` string — The domain for Azure AI Foundry hosted models.
  - AIGatewayModelProviderBedrock — **Pre-release Feature** This feature is currently in beta and is subject to change. Config for AWS model provider.
    - `type` 'bedrock', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required
      - `auth` union, required
        - AIGatewayModelProviderConfigAuthBasic — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
          - `type` 'basic', required
          - `headers` object[]
            - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `params` object[]
            - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
        - AIGatewayModelProviderConfigAuthAWS — **Pre-release Feature** This feature is currently in beta and is subject to change. Configuration for AWS model provider.
          - `type` 'aws', required
          - `access_key_id` string — The access key id for authenticating with static IAM User credentials. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `secret_access_key` string — The secret access key for authenticating with static IAM User credentials. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `session_token` string — The session token for authenticating with temporary IAM credentials (issued by AWS STS, Vault, or SSO/SAML). It is sent to AWS as the `X-Amz-Security-Token` header. Because temporary credentials are short-lived, reference this from a secrets backend so it is refreshed before it expires. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `assume_role_arn` string — The ARN of the IAM role to assume for generating authentication tokens. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `role_session_name` string — The session name for the temporary credentials when assuming the IAM role. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `sts_endpoint_url` string — The STS endpoint URL to use for generating authentication tokens. If not specified, the default AWS STS endpoint will be used.
          - `batch_role_arn` string — AWS role arn to use when calling the batch API.
  - AIGatewayModelProviderCerebras — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `type` 'cerebras', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - AIGatewayModelProviderCohere — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `type` 'cohere', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - AIGatewayModelProviderDashscope — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `type` 'dashscope', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - AIGatewayModelProviderDatabricks — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `type` 'databricks', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - AIGatewayModelProviderDeepseek — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `type` 'deepseek', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - AIGatewayModelProviderGemini — **Pre-release Feature** This feature is currently in beta and is subject to change. Config for GCP model provider.
    - `type` 'gemini', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required
      - `auth` union, required
        - AIGatewayModelProviderConfigAuthBasic — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
          - `type` 'basic', required
          - `headers` object[]
            - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `params` object[]
            - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
        - AIGatewayModelProviderConfigAuthGCP — **Pre-release Feature** This feature is currently in beta and is subject to change. Configuration for GCP model provider.
          - `type` 'gcp', required
          - `service_account_json` string — Full JSON string of the GCP service account to authenticate. If not set (and gcp_use_service_account is true), the service account JSON will be from the environment variable GCP_SERVICE_ACCOUNT. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `metadata_url` string — Custom metadata URL for GCP authentication. Useful for restricted network environments or custom GCP endpoints. If not set, Kong will use the default Google metadata endpoint. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `oauth_token_url` string — Custom OAuth token URL for GCP authentication. Useful for restricted network environments or custom GCP endpoints. If not set, Kong will use the default Google OAuth token endpoint. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `use_gcp_service_account` boolean — Use service account auth for GCP-based providers and models.
  - AIGatewayModelProviderHuggingface — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `type` 'huggingface', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - AIGatewayModelProviderKimi — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `type` 'kimi', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - AIGatewayModelProviderLlama2 — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `type` 'llama2', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - AIGatewayModelProviderMistral — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `type` 'mistral', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - AIGatewayModelProviderOllama — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `type` 'ollama', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - AIGatewayModelProviderOpenai — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `type` 'openai', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - AIGatewayModelProviderVercel — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `type` 'vercel', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - AIGatewayModelProviderVllm — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `type` 'vllm', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - AIGatewayModelProviderXai — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `type` 'xai', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - AIGatewayModelProviderSagemaker — **Pre-release Feature** This feature is currently in beta and is subject to change. Config for Sagemaker model provider.
    - `type` 'sagemaker', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — **Pre-release Feature** This feature is currently in beta and is subject to change.
      - `auth` union, required
        - AIGatewayModelProviderConfigAuthBasic — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
          - `type` 'basic', required
          - `headers` object[]
            - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `params` object[]
            - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
        - AIGatewayModelProviderConfigAuthSagemaker — **Pre-release Feature** This feature is currently in beta and is subject to change. Auth configuration for Sagemaker model provider.
          - `type` 'sagemaker', required
          - `aws` object
            - `access_key_id` string — static IAM user credential; overrides AWS_ACCESS_KEY_ID env var
            - `secret_access_key` string — static IAM user credential; overrides AWS_SECRET_ACCESS_KEY env var
            - `session_token` string — static IAM user credential; overrides AWS_SESSION_TOKEN env var

## Response `201`

Model provider created successfully.

- union — **Pre-release Feature** This feature is currently in beta and is subject to change.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'anthropic', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change. Config for Azure model provider.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'azure', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required
      - `auth` union, required
        - AIGatewayModelProviderConfigAuthBasic — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
          - `type` 'basic', required
          - `headers` object[]
            - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `params` object[]
            - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
        - AIGatewayModelProviderConfigAuthAzure — **Pre-release Feature** This feature is currently in beta and is subject to change. Configuration for Azure model provider.
          - `type` 'azure', required
          - `client_id` string — If azure_use_managed_identity is set to true, and you need to use a different user-assigned identity for this LLM instance, set the client ID. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `client_secret` string — If azure_use_managed_identity is set to true, and you need to use a different user-assigned identity for this LLM instance, set the client secret. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `tenant_id` string — If azure_use_managed_identity is set to true, and you need to use a different user-assigned identity for this LLM instance, set the tenant ID. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `use_managed_identity` boolean — Set true to use the Azure Cloud Managed Identity (or user-assigned identity) to authenticate with Azure-provider models.
      - `service` 'azure-openai' | 'azure-foundry' — Selects the Azure backend for this provider instance. Use `azure-openai` for Azure OpenAI deployments or `azure-foundry` for Azure AI Foundry.
      - `instance` string — The Azure OpenAI instance name. Required when `service` is `azure-openai`.
      - `foundry` object — Endpoint configuration for Azure AI Foundry hosted models. Required when `service` is `azure-foundry`.
        - `resource` string, required — The Azure AI Foundry resource name.
        - `domain` string — The domain for Azure AI Foundry hosted models.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change. Config for AWS model provider.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'bedrock', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required
      - `auth` union, required
        - AIGatewayModelProviderConfigAuthBasic — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
          - `type` 'basic', required
          - `headers` object[]
            - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `params` object[]
            - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
        - AIGatewayModelProviderConfigAuthAWS — **Pre-release Feature** This feature is currently in beta and is subject to change. Configuration for AWS model provider.
          - `type` 'aws', required
          - `access_key_id` string — The access key id for authenticating with static IAM User credentials. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `secret_access_key` string — The secret access key for authenticating with static IAM User credentials. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `session_token` string — The session token for authenticating with temporary IAM credentials (issued by AWS STS, Vault, or SSO/SAML). It is sent to AWS as the `X-Amz-Security-Token` header. Because temporary credentials are short-lived, reference this from a secrets backend so it is refreshed before it expires. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `assume_role_arn` string — The ARN of the IAM role to assume for generating authentication tokens. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `role_session_name` string — The session name for the temporary credentials when assuming the IAM role. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `sts_endpoint_url` string — The STS endpoint URL to use for generating authentication tokens. If not specified, the default AWS STS endpoint will be used.
          - `batch_role_arn` string — AWS role arn to use when calling the batch API.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'cerebras', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'cohere', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'dashscope', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'databricks', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'deepseek', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change. Config for GCP model provider.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'gemini', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required
      - `auth` union, required
        - AIGatewayModelProviderConfigAuthBasic — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
          - `type` 'basic', required
          - `headers` object[]
            - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `params` object[]
            - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
        - AIGatewayModelProviderConfigAuthGCP — **Pre-release Feature** This feature is currently in beta and is subject to change. Configuration for GCP model provider.
          - `type` 'gcp', required
          - `service_account_json` string — Full JSON string of the GCP service account to authenticate. If not set (and gcp_use_service_account is true), the service account JSON will be from the environment variable GCP_SERVICE_ACCOUNT. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `metadata_url` string — Custom metadata URL for GCP authentication. Useful for restricted network environments or custom GCP endpoints. If not set, Kong will use the default Google metadata endpoint. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `oauth_token_url` string — Custom OAuth token URL for GCP authentication. Useful for restricted network environments or custom GCP endpoints. If not set, Kong will use the default Google OAuth token endpoint. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `use_gcp_service_account` boolean — Use service account auth for GCP-based providers and models.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'huggingface', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'kimi', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'llama2', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'mistral', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'ollama', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'openai', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'vercel', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'vllm', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'xai', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — Configuration for the model provider.
      - `auth` AIGatewayModelProviderConfigAuthBasic, required — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
        - `type` 'basic', required
        - `headers` object[]
          - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
        - `params` object[]
          - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
  - object — **Pre-release Feature** This feature is currently in beta and is subject to change. Config for Sagemaker model provider.
    - `id` string, uuid, required — Contains a unique identifier used for this resource.
    - `created_at` string, date-time, required — An ISO-8601 timestamp representation of entity creation date.
    - `updated_at` string, date-time, required — An ISO-8601 timestamp representation of entity update date.
    - `type` 'sagemaker', required
    - `display_name` string, required — The display name for this model provider instance.
    - `name` string, required — Identifier for an AI Gateway entity. In some cases, this may be the entity name or ID.
    - `labels` PublicLabels — Public labels store information about an entity that can be used for filtering a list of objects. Public labels are intended to store **PUBLIC** metadata. Keys must be of length 1-63 characters, and cannot start with "kong", "konnect", "mesh", "kic", or "_".
    - `managed_by` ManagedBy — Stores information about what manages this entity, such as the tool or system responsible for its lifecycle (for example, `terraform`). Keys must be 1–63 characters long and start with an alphanumeric character.
    - `config` object, required — **Pre-release Feature** This feature is currently in beta and is subject to change.
      - `auth` union, required
        - AIGatewayModelProviderConfigAuthBasic — **Pre-release Feature** This feature is currently in beta and is subject to change. Basic auth config for an upstream model provider.
          - `type` 'basic', required
          - `headers` object[]
            - `name` string, required — The name of the header used for authentication. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `value` string — The auth header value for ‘header_name’, for example ‘Bearer key...’. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
          - `params` object[]
            - `name` string, required — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `value` string — This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `location` 'body' | 'query' — Specify whether the param name and value options go in a query string, or the POST form/JSON body.
        - AIGatewayModelProviderConfigAuthSagemaker — **Pre-release Feature** This feature is currently in beta and is subject to change. Auth configuration for Sagemaker model provider.
          - `type` 'sagemaker', required
          - `aws` object
            - `access_key_id` string — static IAM user credential; overrides AWS_ACCESS_KEY_ID env var
            - `secret_access_key` string — static IAM user credential; overrides AWS_SECRET_ACCESS_KEY env var
            - `session_token` string — static IAM user credential; overrides AWS_SESSION_TOKEN env var

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `409` — Conflict
- `429` — Too Many Requests

---

[API](https://skmtc.net/kong/apis/konnect-api-go-sdk.md) · [All operations](https://skmtc.net/kong/apis/konnect-api-go-sdk/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kong/konnect-api-go-sdk/revisions/b576ea92fca2/schema)