Create Or Update Integration

PUT /v2/integrations/custom

Create Or Update Integration

cURL

curl --request PUT \
  --url https://api.galileo.ai/v2/integrations/custom \
  --header 'Content-Type: application/json' \
  --header 'Galileo-API-Key: <api-key>' \
  --data '
{
  "models": [
    "<string>"
  ],
  "endpoint": "<string>",
  "multi_modal_config": {
    "max_files": 2,
    "max_file_size_bytes": 2
  },
  "authentication_type": "oauth2",
  "default_model": "<string>",
  "authentication_scope": "<string>",
  "oauth2_token_url": "<string>",
  "api_key_header": "<string>",
  "api_key_value": "<string>",
  "custom_llm_config": {
    "file_name": "<string>",
    "class_name": "<string>",
    "init_kwargs": {}
  },
  "token": "<string>"
}
'

200

{
  "id": "<string>",
  "name": "anthropic",
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z",
  "created_by": "<string>",
  "permissions": [],
  "is_selected": false
}

Authorizations

APIKeyHeaderOAuth2PasswordBearerHTTPBasic

Galileo-API-Key · string · header · required

Body

application/json

Schema for creating custom integrations.

Inherits api_key field validation from CustomConfig:

• api_key_header and api_key_value are required when authentication_type is api_key

Token field is only used for oauth2 authentication (contains OAuth2 client credentials). For api_key auth, the api_key_value field is used instead.

models · string[] · required

List of model names for the custom integration

Minimum array length: 1

endpoint · string · required

Endpoint URL for the custom integration.

multi_modal_config · MultiModalModelIntegrationConfig · object

Configuration for multi-modal (file upload) capabilities.

Show child attributes

authentication_type · enum<string> · default: oauth2

Authentication types for custom integrations.

Values:

• none: No authentication required
• oauth2: OAuth2 token-based authentication
• api_key: API key header-based authentication

Available options: api_key, none, oauth2

default_model · string | null

Default model to use. If not provided, defaults to the first model in the models list.

authentication_scope · string | null

Optional scope for OAuth2 authentication.

oauth2_token_url · string | null

OAuth2 token URL for custom OAuth2 authentication. If not provided, defaults to the endpoint.

api_key_header · string | null

HTTP header name to use for API key authentication (e.g., 'X-API-Key', 'Authorization').

api_key_value · string | null

API key value to send in the specified header for authentication.

custom_llm_config · CustomLLMConfig · object

Optional configuration for a custom LiteLLM handler class. When specified, the handler's acompletion() method is used instead of the default litellm.acompletion().

Show child attributes

token · string | null

Response

200

application/json

Successful Response

id · string<uuid4> · required

name · enum<string> · required

Available options: anthropic, aws_bedrock, aws_sagemaker, azure, custom, databricks, labelstudio, mistral, nvidia, openai, vegas_gateway, vertex_ai, writer

created_at · string<date-time> · required

updated_at · string<date-time> · required

created_by · string<uuid4> · required

permissions · Permission · object[]

Show child attributes

is_selected · boolean · default: false