integrations

Create or update a named custom integration

Changed on

Create or update one of the caller's named custom integrations.

Args: name: Slug identifying the named custom integration. ctx: Async request context supplying the read session and current user. integration: Custom-provider credentials, headers and model list.

Returns: The stored integration, without its secret columns.

put/integrations/custom/{name}

Request

  • Base URL
    https://api.galileo.ai
  • URL
    https://api.galileo.ai/integrations/custom/{name}
  • Auth
    • API key in header Splunk-AO-API-Key
    • or API key in header Galileo-API-Key
    • or OAuth 2
      Password
      Token URL: https://api.galileo.ai/login
    • or HTTP basic

Path parameters

namestring required

Slug identifying this named custom integration

Request body

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
modelsstring[] nullable

List of model names for the custom integration. Deprecated: use model_properties instead.

is_legacy_formatboolean

Internal: whether this config was created from the legacy 'models' field.

default_modelstring nullable

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

endpointstring required

Endpoint URL for the custom integration.

authentication_scopestring nullable

Optional scope for OAuth2 authentication.

oauth2_token_urlstring nullable

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

api_key_headerstring nullable

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

api_key_valuestring nullable

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

custom_header_mappingobject 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.

headersobject nullable

Optional custom HTTP headers to include in requests to the integration endpoint. Stored encrypted at rest.

tokenstring nullable

Response

Successful Response

idstring uuid4 required
namestring required
provider'anthropic' | 'aws_bedrock' | 'aws_sagemaker' | 'azure' | 'custom' | 'databricks' | 'mistral' | 'nvidia' | 'openai' | 'vertex_ai' | 'writer' | 'typesafe' required
created_atstring date-time required
updated_atstring date-time required
created_bystring uuid4 required
is_selectedboolean
is_disabledboolean

Changes

  • 0b20eade6391Revision changes
    • warning

      added the new read_all_logs enum value to the /// response property for the response status

    • warning

      added the new read_filtered_logs enum value to the /// response property for the response status

    • info

      removed the vegas_gateway enum value from the response property for the response status

  • 5f37e1acd374Revision changes
    • warning

      added the new typesafe enum value to the response property for the response status