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

# Get an AI Gateway Model Provider

`GET /v1/ai-gateways/{gatewayId}/model-providers/{modelProviderIdOrName}`

## Request

- Base URL: `https://global.api.konghq.com`
- URL: `https://global.api.konghq.com/v1/ai-gateways/{gatewayId}/model-providers/{modelProviderIdOrName}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

Returns the details of a specific AI Gateway model provider.

## Response `200`

A successful response returning an AI Gateway Model Provider.

- union
  - object: Configuration for an upstream 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` '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: 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: 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: 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: 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: 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: 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: 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: Configuration for an upstream 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` '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: 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: Configuration for an upstream 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` '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: 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: Configuration for an upstream 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` '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: 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: Configuration for an upstream 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` '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: 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: Configuration for an upstream 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` '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: 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: 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: 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: 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.
          - `workload_identity_federation` AuthGCPWorkloadIdentityFederation: Enables authenticating with GCP via Workload Identity Federation, obtaining temporary GCP credentials instead of using a static service account key.
            - `source` 'aws_iam', required: The source identity provider/system used to obtain temporary GCP credentials.
            - `auth_json` string: JSON configuration for the Workload Identity Federation token exchange (Google's `external_account` credential config: audience, token URL, credential source, and optional service account impersonation URL). If not set, Kong falls back to the file path in the `GOOGLE_APPLICATION_CREDENTIALS` environment variable. This field is [referenceable](https://developer.konghq.com/gateway/entities/vault/#how-do-i-reference-secrets-stored-in-a-vault).
            - `aws` AIGatewayUpstreamAuthAWS: AWS IAM (SigV4) authentication for the upstream service.
              - …
  - object: Configuration for an upstream 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` '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: 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: Configuration for an upstream 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` '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: 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: Configuration for an upstream 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` '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: 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: Configuration for an upstream 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` '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: 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: Configuration for an upstream 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` '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: 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: Configuration for an upstream 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` '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: 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: Configuration for an upstream 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` '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: 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: Configuration for an upstream 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` '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: 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: Configuration for an upstream 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` '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: 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: 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
      - `auth` union, required
        - AIGatewayModelProviderConfigAuthBasic: 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: 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
  - object: Configuration for an upstream 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` 'typesafe', 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: 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.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found
- `429`: Too Many Requests

## Changes

- **2026-09-30** `de79e1192f11`: 1 breaking, 1 info
  - added `#/components/schemas/AIGatewayModelProviderTypesafe` to the response body `oneOf` list for the response status `200`
  - added `typesafe` mapping keys to the response discriminator for the response status `200`
- **2026-09-25** `68d43091b84d`: 2 warning
  - added the new `403.00` enum value to the `status` response property for the response status `403`
  - added the new `404.00` enum value to the `status` response property for the response status `404`
- **2026-09-18** `f324fb7610e4`: 3 breaking, 44 info
  - the response's body type changed from no type to `object` for status `403`
  - the response's body type changed from no type to `object` for status `404`
  - the response's body type changed from no type to `object` for status `429`
  - removed `#/components/schemas/BaseError, subschema #2` from the response body `allOf` list for the response status `401`
  - …43 more
- **2026-09-07** `d2254a6fbee0`: 1 info
  - added the optional property `oneOf[#/components/schemas/AIGatewayModelProviderGemini]/config/auth/oneOf[subschema #2: AIGatewayModelProviderConfigAuthGCP]/workload_identity_federation` to the response with the `200` status
- **2026-08-20** `b576ea92fca2`: 2 info
  - removed `vertex` mapping keys from the response discriminator for the response status `200`
  - removed `#/components/schemas/AIGatewayModelProviderVertex` from the response body `oneOf` list for the response status `200`

[Operation history](https://skmtc.dev/kong/apis/konnect-api-go-sdk/changes/v1/ai-gateways/:gatewayId/model-providers/:modelProviderIdOrName/get.md)

---

[API](https://skmtc.dev/kong/apis/konnect-api-go-sdk.md) · [All operations](https://skmtc.dev/kong/apis/konnect-api-go-sdk/llms.txt) · [OpenAPI document](https://skmtc.dev/kong/apis/konnect-api-go-sdk/revisions/7aab863a6daa?raw)