---
title: "Post LLM Provider entities"
method: POST
path: "/api/v1/entities/llmProviders"
tags: ["LLM Providers"]
---

# Post LLM Provider entities

`POST /api/v1/entities/llmProviders`

## Request

- Base URL: `https://www.gooddata.ai`
- URL: `https://www.gooddata.ai/api/v1/entities/llmProviders`
- Auth: none declared

LLM Provider - connection configuration for LLM services

## Request body

- JsonApiLlmProviderInDocument
  - `data` JsonApiLlmProviderIn, required: LLM Provider configuration for connecting to LLM services.
    - `attributes` object
      - `defaultModelId` string, nullable: Required ID of the default model to use from the models list.
      - `description` string, nullable: Description of the LLM Provider.
      - `models` object[], nullable: List of LLM models available for this provider.
        - `family` 'OPENAI' | 'ANTHROPIC' | 'META' | 'MISTRAL' | 'AMAZON' | 'GOOGLE' | 'COHERE' | 'UNKNOWN', required: Family of LLM models.
        - `id` string, required: Unique identifier of the model (e.g., gpt-5.3, claude-4.6).
      - `name` string, nullable
      - `providerConfig` union: Provider-specific configuration including authentication.
        - object: Configuration for OpenAI provider.
          - `auth` OpenAiProviderAuth, required: Authentication configuration.
            - `apiKey` string, nullable: OpenAI API key.
            - `type` 'API_KEY', required: Authentication type.
          - `baseUrl` string: Custom base URL for OpenAI API.
          - `organization` string, nullable: OpenAI organization ID.
          - `type` 'OPENAI', required: Provider type.
        - object: Configuration for Azure Foundry provider.
          - `auth` AzureFoundryProviderAuth, required: Authentication configuration.
            - `apiKey` string, nullable: Azure API key.
            - `type` 'API_KEY', required: Authentication type.
          - `endpoint` string, required: Azure OpenAI endpoint URL.
          - `type` 'AZURE_FOUNDRY', required: Provider type.
        - object: Configuration for AWS Bedrock provider.
          - `auth` BedrockProviderAuth, required: Authentication configuration.
            - `accessKeyId` string, nullable: AWS Access Key ID.
            - `secretAccessKey` string, nullable: AWS Secret Access Key.
            - `sessionToken` string, nullable: AWS Session Token (for temporary credentials).
            - `type` 'ACCESS_KEY', required: Authentication type.
          - `region` string, required: AWS region for Bedrock.
          - `type` 'AWS_BEDROCK', required: Provider type.
        - object: Configuration for Anthropic provider.
          - `auth` AnthropicProviderAuth, required: Authentication configuration.
            - `apiKey` string, nullable: Anthropic API key.
            - `type` 'API_KEY', required: Authentication type.
          - `baseUrl` string: Custom base URL for the Anthropic API. Defaults to the official endpoint; override only for enterprise proxies or compatible gateways.
          - `type` 'ANTHROPIC', required: Provider type.
    - `id` string, required: API identifier of an object
    - `type` 'llmProvider', required: Object type

## Response `201`

Request successfully processed

- JsonApiLlmProviderOutDocument
  - `data` JsonApiLlmProviderOut, required: LLM Provider configuration for connecting to LLM services.
    - `attributes` object
      - `defaultModelId` string, nullable: Required ID of the default model to use from the models list.
      - `description` string, nullable: Description of the LLM Provider.
      - `models` object[], nullable: List of LLM models available for this provider.
        - `family` 'OPENAI' | 'ANTHROPIC' | 'META' | 'MISTRAL' | 'AMAZON' | 'GOOGLE' | 'COHERE' | 'UNKNOWN', required: Family of LLM models.
        - `id` string, required: Unique identifier of the model (e.g., gpt-5.3, claude-4.6).
      - `name` string, nullable
      - `providerConfig` union: Provider-specific configuration including authentication.
        - object: Configuration for OpenAI provider.
          - `auth` OpenAiProviderAuth, required: Authentication configuration.
            - `apiKey` string, nullable: OpenAI API key.
            - `type` 'API_KEY', required: Authentication type.
          - `baseUrl` string: Custom base URL for OpenAI API.
          - `organization` string, nullable: OpenAI organization ID.
          - `type` 'OPENAI', required: Provider type.
        - object: Configuration for Azure Foundry provider.
          - `auth` AzureFoundryProviderAuth, required: Authentication configuration.
            - `apiKey` string, nullable: Azure API key.
            - `type` 'API_KEY', required: Authentication type.
          - `endpoint` string, required: Azure OpenAI endpoint URL.
          - `type` 'AZURE_FOUNDRY', required: Provider type.
        - object: Configuration for AWS Bedrock provider.
          - `auth` BedrockProviderAuth, required: Authentication configuration.
            - `accessKeyId` string, nullable: AWS Access Key ID.
            - `secretAccessKey` string, nullable: AWS Secret Access Key.
            - `sessionToken` string, nullable: AWS Session Token (for temporary credentials).
            - `type` 'ACCESS_KEY', required: Authentication type.
          - `region` string, required: AWS region for Bedrock.
          - `type` 'AWS_BEDROCK', required: Provider type.
        - object: Configuration for Anthropic provider.
          - `auth` AnthropicProviderAuth, required: Authentication configuration.
            - `apiKey` string, nullable: Anthropic API key.
            - `type` 'API_KEY', required: Authentication type.
          - `baseUrl` string: Custom base URL for the Anthropic API. Defaults to the official endpoint; override only for enterprise proxies or compatible gateways.
          - `type` 'ANTHROPIC', required: Provider type.
    - `id` string, required: API identifier of an object
    - `type` 'llmProvider', required: Object type
  - `links` ObjectLinks
    - `self` string, uri, required: A string containing the link's URL.

---

[API](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api.md) - [All operations](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gooddata/apis/gooddata-cn-oapi-all-api/revisions/c728ef303bfb?raw)