---
title: "Configure the organization's AI provider"
method: POST
path: "/v2/organizations/settings/aiConfigs"
tags: ["Organizations"]
---

# Configure the organization's AI provider

`POST /v2/organizations/settings/aiConfigs`

## Request

- Base URL: `https://api.sigmacomputing.com`
- URL: `https://api.sigmacomputing.com/v2/organizations/settings/aiConfigs`
- Auth: HTTP bearer

Configure the AI provider for the organization associated with the API credentials. Choose one provider for LLM interactions, and optionally a separate provider for embeddings.

### Usage notes
- To perform this operation, you must use API credentials owned by a user assigned the Admin account type.
- Providers differ in which models and regions they support. Review [Supported AI models](https://help.sigmacomputing.com/docs/supported-ai-models) and [Set up an AI provider](https://help.sigmacomputing.com/docs/configure-ai-features-for-your-organization#set-up-an-ai-provider) first.
- Retrieve the **connectionId** by calling the [/v2/connections](/reference/list-connections) endpoint.
- `embeddedModel` is optional for warehouse providers, OpenAI, Gemini, and Bedrock. If you omit it, the embedding model for the LLM provider is used. Required for Anthropic and Azure OpenAI.

### Usage scenarios
- **Automated organization setup:** Configure the AI provider as part of onboarding or infrastructure-as-code, rather than clicking through the administration portal.
- **Sigma Tenants:** Set the AI provider for each tenant organization programmatically, using impersonation to target a specific tenant.

## Request body

- union: The AI provider to configure for the organization.
  - OrganizationsCreateAiConfigRequest0
    - `provider` 'snowflake', required
    - `connectionId` string, required: ID of the connection to use as an AI provider.
    - `embeddedModel` union
      - AiSnowflakeEmbeddedModel
        - `provider` 'snowflake', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiBigQueryEmbeddedModel
        - `provider` 'bigquery', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
        - `region` string: For a BigQuery connection, Vertex AI location for the project. Defaults to `us-central1`.
      - AiDatabricksEmbeddedModel
        - `provider` 'databricks', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiOpenAiEmbeddedModel
        - `provider` 'openAI', required
        - `apiKey` string, required: OpenAI API key.
      - AiGeminiEmbeddedModel
        - `provider` 'gemini', required
        - `apiKey` string, required: Gemini API key.
  - OrganizationsCreateAiConfigRequest1
    - `provider` 'bigquery', required
    - `connectionId` string, required: ID of the connection to use as an AI provider.
    - `region` string: For a BigQuery connection, Vertex AI location for the project. Defaults to `us-central1`.
    - `embeddedModel` union
      - AiSnowflakeEmbeddedModel
        - `provider` 'snowflake', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiBigQueryEmbeddedModel
        - `provider` 'bigquery', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
        - `region` string: For a BigQuery connection, Vertex AI location for the project. Defaults to `us-central1`.
      - AiDatabricksEmbeddedModel
        - `provider` 'databricks', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiOpenAiEmbeddedModel
        - `provider` 'openAI', required
        - `apiKey` string, required: OpenAI API key.
      - AiGeminiEmbeddedModel
        - `provider` 'gemini', required
        - `apiKey` string, required: Gemini API key.
  - OrganizationsCreateAiConfigRequest2
    - `provider` 'databricks', required
    - `connectionId` string, required: ID of the connection to use as an AI provider.
    - `embeddedModel` union
      - AiSnowflakeEmbeddedModel
        - `provider` 'snowflake', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiBigQueryEmbeddedModel
        - `provider` 'bigquery', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
        - `region` string: For a BigQuery connection, Vertex AI location for the project. Defaults to `us-central1`.
      - AiDatabricksEmbeddedModel
        - `provider` 'databricks', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiOpenAiEmbeddedModel
        - `provider` 'openAI', required
        - `apiKey` string, required: OpenAI API key.
      - AiGeminiEmbeddedModel
        - `provider` 'gemini', required
        - `apiKey` string, required: Gemini API key.
  - OrganizationsCreateAiConfigRequest3
    - `provider` 'openAI', required
    - `apiKey` string, required: OpenAI API key.
    - `embeddedModel` union
      - AiSnowflakeEmbeddedModel
        - `provider` 'snowflake', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiBigQueryEmbeddedModel
        - `provider` 'bigquery', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
        - `region` string: For a BigQuery connection, Vertex AI location for the project. Defaults to `us-central1`.
      - AiDatabricksEmbeddedModel
        - `provider` 'databricks', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiOpenAiEmbeddedModel
        - `provider` 'openAI', required
        - `apiKey` string, required: OpenAI API key.
      - AiGeminiEmbeddedModel
        - `provider` 'gemini', required
        - `apiKey` string, required: Gemini API key.
  - OrganizationsCreateAiConfigRequest4
    - `provider` 'gemini', required
    - `apiKey` string, required: Gemini API key.
    - `embeddedModel` union
      - AiSnowflakeEmbeddedModel
        - `provider` 'snowflake', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiBigQueryEmbeddedModel
        - `provider` 'bigquery', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
        - `region` string: For a BigQuery connection, Vertex AI location for the project. Defaults to `us-central1`.
      - AiDatabricksEmbeddedModel
        - `provider` 'databricks', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiOpenAiEmbeddedModel
        - `provider` 'openAI', required
        - `apiKey` string, required: OpenAI API key.
      - AiGeminiEmbeddedModel
        - `provider` 'gemini', required
        - `apiKey` string, required: Gemini API key.
  - OrganizationsCreateAiConfigRequest5
    - `provider` 'anthropic', required
    - `apiKey` string, required: Anthropic API key.
    - `embeddedModel` union, required
      - AiSnowflakeEmbeddedModel
        - `provider` 'snowflake', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiBigQueryEmbeddedModel
        - `provider` 'bigquery', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
        - `region` string: For a BigQuery connection, Vertex AI location for the project. Defaults to `us-central1`.
      - AiDatabricksEmbeddedModel
        - `provider` 'databricks', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiOpenAiEmbeddedModel
        - `provider` 'openAI', required
        - `apiKey` string, required: OpenAI API key.
      - AiGeminiEmbeddedModel
        - `provider` 'gemini', required
        - `apiKey` string, required: Gemini API key.
  - OrganizationsCreateAiConfigRequest6
    - `provider` 'bedrock', required
    - `iamRoleArn` string, required: ARN of the IAM role for Sigma to assume.
    - `awsRegion` string, required: AWS region of the Bedrock deployment.
    - `embeddedModel` union
      - AiSnowflakeEmbeddedModel
        - `provider` 'snowflake', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiBigQueryEmbeddedModel
        - `provider` 'bigquery', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
        - `region` string: For a BigQuery connection, Vertex AI location for the project. Defaults to `us-central1`.
      - AiDatabricksEmbeddedModel
        - `provider` 'databricks', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiOpenAiEmbeddedModel
        - `provider` 'openAI', required
        - `apiKey` string, required: OpenAI API key.
      - AiGeminiEmbeddedModel
        - `provider` 'gemini', required
        - `apiKey` string, required: Gemini API key.
  - OrganizationsCreateAiConfigRequest7
    - `provider` 'azureOpenAI', required
    - `openAIDeployment` V2OrganizationsSettingsAiConfigsPostRequestBodyContentApplicationJsonSchemaOneOf7OpenAiDeployment, required: The Azure OpenAI deployment to use for the LLM provider.
      - `deploymentId` string, required: Azure OpenAI deployment ID.
      - `endpointURL` string, required: Azure OpenAI endpoint URL.
      - `apiKey` string, required: Azure OpenAI API key.
    - `embeddedModel` union, required: The provider to use for embeddings. Required for Azure OpenAI, which can use its own embeddings deployment or a different provider.
      - AiSnowflakeEmbeddedModel
        - `provider` 'snowflake', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiBigQueryEmbeddedModel
        - `provider` 'bigquery', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
        - `region` string: For a BigQuery connection, Vertex AI location for the project. Defaults to `us-central1`.
      - AiDatabricksEmbeddedModel
        - `provider` 'databricks', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiOpenAiEmbeddedModel
        - `provider` 'openAI', required
        - `apiKey` string, required: OpenAI API key.
      - AiGeminiEmbeddedModel
        - `provider` 'gemini', required
        - `apiKey` string, required: Gemini API key.
      - AiAzureEmbeddedModel
        - `provider` 'azureOpenAI', required
        - `deploymentId` string, required: Azure OpenAI deployment ID.
        - `endpointURL` string, required: Azure OpenAI endpoint URL.
        - `apiKey` string, required: Azure OpenAI API key.

## Response `200`

The response body.

- union
  - OrganizationsCreateAiConfigResponse2000
    - `provider` 'snowflake' | 'bigquery' | 'databricks', required
    - `connectionId` string, required: ID of the connection to use as an AI provider.
    - `embeddedModel` union
      - AiEmbeddedModelRes0
        - `provider` 'snowflake', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiEmbeddedModelRes1
        - `provider` 'bigquery', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiEmbeddedModelRes2
        - `provider` 'databricks', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiEmbeddedModelRes3
        - `provider` 'openAI', required
      - AiEmbeddedModelRes4
        - `provider` 'gemini', required
  - OrganizationsCreateAiConfigResponse2001
    - `provider` 'openAI', required
    - `embeddedModel` union
      - AiEmbeddedModelRes0
        - `provider` 'snowflake', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiEmbeddedModelRes1
        - `provider` 'bigquery', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiEmbeddedModelRes2
        - `provider` 'databricks', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiEmbeddedModelRes3
        - `provider` 'openAI', required
      - AiEmbeddedModelRes4
        - `provider` 'gemini', required
  - OrganizationsCreateAiConfigResponse2002
    - `provider` 'gemini', required
    - `embeddedModel` union
      - AiEmbeddedModelRes0
        - `provider` 'snowflake', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiEmbeddedModelRes1
        - `provider` 'bigquery', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiEmbeddedModelRes2
        - `provider` 'databricks', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiEmbeddedModelRes3
        - `provider` 'openAI', required
      - AiEmbeddedModelRes4
        - `provider` 'gemini', required
  - OrganizationsCreateAiConfigResponse2003
    - `provider` 'anthropic', required
    - `embeddedModel` union, required
      - AiEmbeddedModelRes0
        - `provider` 'snowflake', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiEmbeddedModelRes1
        - `provider` 'bigquery', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiEmbeddedModelRes2
        - `provider` 'databricks', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiEmbeddedModelRes3
        - `provider` 'openAI', required
      - AiEmbeddedModelRes4
        - `provider` 'gemini', required
  - OrganizationsCreateAiConfigResponse2004
    - `provider` 'bedrock', required
    - `iamRoleArn` string, required: ARN of the IAM role for Sigma to assume.
    - `awsRegion` string, required: AWS region of the Bedrock deployment.
    - `embeddedModel` union
      - AiEmbeddedModelRes0
        - `provider` 'snowflake', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiEmbeddedModelRes1
        - `provider` 'bigquery', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiEmbeddedModelRes2
        - `provider` 'databricks', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - AiEmbeddedModelRes3
        - `provider` 'openAI', required
      - AiEmbeddedModelRes4
        - `provider` 'gemini', required
    - `awsTrustExternalId` string, required: External ID to add to your IAM role's trust policy to complete Bedrock setup. Returned only by this request.
  - OrganizationsCreateAiConfigResponse2005
    - `provider` 'azureOpenAI', required
    - `openAIDeployment` V2OrganizationsSettingsAiConfigsPostResponsesContentApplicationJsonSchemaOneOf5OpenAiDeployment, required
      - `deploymentId` string, required: Azure OpenAI deployment ID.
      - `endpointURL` string, required: Azure OpenAI endpoint URL.
    - `embeddedModel` union, required: The configured embeddings provider. API keys are never included in the response.
      - V2OrganizationsSettingsAiConfigsPostResponsesContentApplicationJsonSchemaOneOf5EmbeddedModel0
        - `provider` 'snowflake', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - V2OrganizationsSettingsAiConfigsPostResponsesContentApplicationJsonSchemaOneOf5EmbeddedModel1
        - `provider` 'bigquery', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - V2OrganizationsSettingsAiConfigsPostResponsesContentApplicationJsonSchemaOneOf5EmbeddedModel2
        - `provider` 'databricks', required
        - `connectionId` string, required: ID of the connection to use as an AI provider.
      - V2OrganizationsSettingsAiConfigsPostResponsesContentApplicationJsonSchemaOneOf5EmbeddedModel3
        - `provider` 'openAI', required
      - V2OrganizationsSettingsAiConfigsPostResponsesContentApplicationJsonSchemaOneOf5EmbeddedModel4
        - `provider` 'gemini', required
      - V2OrganizationsSettingsAiConfigsPostResponsesContentApplicationJsonSchemaOneOf5EmbeddedModel5
        - `provider` 'azureOpenAI', required
        - `deploymentId` string, required: Azure OpenAI deployment ID.
        - `endpointURL` string, required: Azure OpenAI endpoint URL.

---

[API](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api.md) - [All operations](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sigmacomputing/apis/sigma-rest-api/revisions/fb6036208c49?raw)