---
title: "Get Integration"
method: GET
path: "/v2/integrations/{name}"
tags: ["integrations"]
---

# Get Integration

`GET /v2/integrations/{name}`

Gets the integration data formatted for the specified integration.

## Path parameters

- `name` 'anthropic' | 'aws_bedrock' | 'aws_sagemaker' | 'azure' | 'custom' | 'databricks' | 'mistral' | 'nvidia' | 'openai' | 'vegas_gateway' | 'vertex_ai' | 'writer', required

## Response `200`

Successful Response

- union
  - AwsBedrockIntegration
    - `multi_modal_config` MultiModalModelIntegrationConfig — Configuration for multi-modal capabilities (file uploads).
      - `max_files` integer, nullable — Maximum number of files allowed per request. None means no limit.
      - `max_file_size_bytes` integer, nullable — Maximum file size in bytes per file. None means no limit.
    - `credential_type` 'assumed_role' | 'key_secret'
    - `region` string
    - `inference_profiles` object — Mapping from model name (Foundation model ID) to inference profile ARN or ID
    - `id` string, uuid4, nullable
    - `name` 'aws_bedrock'
    - `provider` 'aws_bedrock'
    - `extra` object, nullable
  - AwsSageMakerIntegration
    - `credential_type` 'assumed_role' | 'key_secret'
    - `region` string
    - `multi_modal_config` MultiModalModelIntegrationConfig — Configuration for multi-modal capabilities (file uploads).
      - `max_files` integer, nullable — Maximum number of files allowed per request. None means no limit.
      - `max_file_size_bytes` integer, nullable — Maximum file size in bytes per file. None means no limit.
    - `models` Model[]
      - `name` string, required
      - `alias` string, required
      - `integration` 'anthropic' | 'aws_bedrock' | 'aws_sagemaker' | 'azure' | 'custom' | 'databricks' | 'mistral' | 'nvidia' | 'openai' | 'vegas_gateway' | 'vertex_ai' | 'writer'
      - `user_role` string, nullable
      - `assistant_role` string, nullable
      - `system_supported` boolean
      - `input_modalities` ContentModality[] — Input modalities that the model can accept.
      - `alternative_names` string[] — Alternative names for the model, used for matching with various current, versioned or legacy names.
      - `input_token_limit` integer, nullable
      - `output_token_limit` integer, nullable
      - `token_limit` integer, nullable
      - `cost_by` 'tokens' | 'characters'
      - `is_chat` boolean
      - `provides_log_probs` boolean
      - `formatting_tokens` integer
      - `response_prefix_tokens` integer
      - `api_version` string, nullable
      - `legacy_mistral_prompt_format` boolean
      - `requires_max_tokens` boolean
      - `max_top_p` number, nullable
      - `params_map` RunParamsMap — Maps the internal settings parameters (left) to the serialized parameters (right) we want to send in the API requests.
        - `model` string, nullable
        - `temperature` string, nullable
        - `max_tokens` string, nullable
        - `stop_sequences` string, nullable
        - `top_p` string, nullable
        - `top_k` string, nullable
        - `frequency_penalty` string, nullable
        - `presence_penalty` string, nullable
        - `echo` string, nullable
        - `logprobs` string, nullable
        - `top_logprobs` string, nullable
        - `n` string, nullable
        - `api_version` string, nullable
        - `tools` string, nullable
        - `tool_choice` string, nullable
        - `response_format` string, nullable
        - `reasoning_effort` string, nullable
        - `verbosity` string, nullable
        - `deployment_name` string, nullable
      - `output_map` OutputMap
        - `response` string, required
        - `token_count` string, nullable
        - `input_token_count` string, nullable
        - `output_token_count` string, nullable
        - `completion_reason` string, nullable
      - `input_map` InputMap
        - `prompt` string, required
        - `prefix` string
        - `suffix` string
    - `id` string, uuid4, nullable
    - `name` 'aws_sagemaker'
    - `provider` 'aws_sagemaker'
    - `extra` object, nullable
  - AzureIntegration
    - `multi_modal_config` MultiModalModelIntegrationConfig — Configuration for multi-modal capabilities (file uploads).
      - `max_files` integer, nullable — Maximum number of files allowed per request. None means no limit.
      - `max_file_size_bytes` integer, nullable — Maximum file size in bytes per file. None means no limit.
    - `proxy` boolean
    - `endpoint` string, required
    - `api_version` string
    - `azure_deployment` string, nullable
    - `authentication_type` 'api_key' | 'client_secret' | 'username_password' | 'custom_oauth2'
    - `authentication_scope` string, nullable
    - `default_headers` object, nullable
    - `deployments` object
    - `oauth2_token_url` string, nullable — OAuth2 token URL for custom OAuth2 authentication
    - `custom_header_mapping` object, nullable — Custom header mapping from internal fields to be included in the LLM request.
    - `available_deployments` AzureModelDeployment[], nullable — The available deployments for this integration. If provided, we will not try to get this list from Azure.
      - `model` string, required — The name of the model.
      - `id` string, required — The ID of the deployment.
    - `id` string, uuid4, nullable
    - `name` 'azure'
    - `provider` 'azure'
    - `extra` object, nullable
  - AnthropicIntegration
    - `multi_modal_config` MultiModalModelIntegrationConfig — Configuration for multi-modal capabilities (file uploads).
      - `max_files` integer, nullable — Maximum number of files allowed per request. None means no limit.
      - `max_file_size_bytes` integer, nullable — Maximum file size in bytes per file. None means no limit.
    - `authentication_type` 'api_key' | 'custom_oauth2'
    - `endpoint` string, nullable — Custom base URL for the Anthropic API. Required if `proxy` is True.
    - `authentication_scope` string, nullable
    - `oauth2_token_url` string, nullable — OAuth2 token URL for custom OAuth2 authentication
    - `custom_header_mapping` object, nullable — Custom header mapping from internal fields to be included in the LLM request.
    - `id` string, uuid4, nullable
    - `name` 'anthropic'
    - `provider` 'anthropic'
    - `extra` object, nullable
  - CustomIntegration — Read model for custom integrations. api_key_value is not stored in extra (it's encrypted in the token column), so we override the parent validator to skip requiring it on read. Headers are not returned on read (they're encrypted and sensitive).
    - `multi_modal_config` MultiModalModelIntegrationConfig — Configuration for multi-modal capabilities (file uploads).
      - `max_files` integer, nullable — Maximum number of files allowed per request. None means no limit.
      - `max_file_size_bytes` integer, nullable — Maximum file size in bytes per file. None means no limit.
    - `authentication_type` 'api_key' | 'none' | 'oauth2' — Authentication types for custom integrations. Values: - none: No authentication required - oauth2: OAuth2 token-based authentication - api_key: API key header-based authentication
    - `models` string[], nullable — List of model names for the custom integration. Deprecated: use model_properties instead.
    - `model_properties` ModelProperties[], nullable — List of model properties with name and alias for the custom integration.
      - `name` string, required — The model name used when calling the API.
      - `alias` string, nullable — The display name/alias for the model. Defaults to name.
      - `based_on` string, nullable — Alias of a built-in model whose parameter map should be used. For example, 'gpt-5.4'. Mutually exclusive with supported_parameters.
      - `supported_parameters` string[], nullable — Explicit list of parameter names this model supports (e.g., ['max_tokens', 'temperature', 'verbosity']). Each name must be a valid RunParamsMap field. Mutually exclusive with based_on.
    - `is_legacy_format` boolean — Internal: whether this config was created from the legacy 'models' field.
    - `default_model` string, nullable — Default model to use. If not provided, defaults to the first model.
    - `base_url` string, required — Endpoint URL for the custom integration.
    - `authentication_scope` string, nullable — Optional scope for OAuth2 authentication.
    - `oauth2_token_url` string, nullable — OAuth2 token URL for custom OAuth2 authentication. If not provided, defaults to the endpoint.
    - `api_key_header` string, nullable — HTTP header name to use for API key authentication (e.g., 'X-API-Key', 'Authorization').
    - `api_key_value` string, nullable — API key value to send in the specified header for authentication.
    - `custom_llm_config` CustomLLMConfig — Configuration for a custom LiteLLM handler class. Allows users to specify a custom implementation of litellm.CustomLLM that handles acompletion() calls with custom request/response transformation.
      - `file_name` string, required — Python file name containing the CustomLLM class (e.g., 'my_handler.py')
      - `class_name` string, required — Class name within the module (must be a litellm.CustomLLM subclass)
      - `init_kwargs` object, nullable — Optional keyword arguments to pass to the CustomLLM constructor
    - `custom_header_mapping` object, nullable — Custom header mapping from internal fields (job_id, user_id, project_id, run_id) to custom header names to be included in LLM requests.
    - `headers` object, nullable
    - `id` string, uuid4, nullable
    - `name` string
    - `provider` 'custom'
    - `extra` object, nullable
  - DatabricksIntegration
    - `id` string, uuid4, nullable
    - `name` 'databricks'
    - `provider` 'databricks'
    - `extra` object, nullable
  - MistralIntegration
    - `id` string, uuid4, nullable
    - `name` 'mistral'
    - `provider` 'mistral'
    - `extra` object, nullable
  - NvidiaIntegration
    - `id` string, uuid4, nullable
    - `name` 'nvidia'
    - `provider` 'nvidia'
    - `extra` object, nullable
  - OpenAIIntegration
    - `organization_id` string, nullable
    - `id` string, uuid4, nullable
    - `name` 'openai'
    - `provider` 'openai'
    - `extra` object, nullable
  - VegasGatewayIntegration
    - `id` string, uuid4, nullable
    - `name` 'vegas_gateway'
    - `provider` 'vegas_gateway'
    - `extra` object, nullable
  - VertexAIIntegration
    - `multi_modal_config` MultiModalModelIntegrationConfig — Configuration for multi-modal capabilities (file uploads).
      - `max_files` integer, nullable — Maximum number of files allowed per request. None means no limit.
      - `max_file_size_bytes` integer, nullable — Maximum file size in bytes per file. None means no limit.
    - `gcs_config` VertexAIGCSConfigResponse — GCS config response model — credentials are never exposed in GET responses.
      - `bucket_name` string, required
      - `object_path_prefix` string, required
    - `id` string, uuid4, nullable
    - `name` 'vertex_ai'
    - `provider` 'vertex_ai'
    - `extra` object, nullable
  - WriterIntegration
    - `organization_id` string, required
    - `id` string, uuid4, nullable
    - `name` 'writer'
    - `provider` 'writer'
    - `extra` object, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/galileo/apis/fastapi.md) · [All operations](https://skmtc.net/galileo/apis/fastapi/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/galileo/fastapi/versions/441b96da8c30/schema)