/*
* server
*
* ## Real-time data The only real-time path to get tracing data is to ingest via OpenTelemetry (`POST /api/public/otel/v1/traces`) and retrieve via Observations API v2 (`GET /api/public/v2/observations`) and Metrics API v2 (`GET /api/public/v2/metrics`). Other public API write and read endpoints can delay data by about 10 minutes. Direct OpenTelemetry exporters must send the `x-langfuse-ingestion-version: 4` header; current Python and JS SDKs already do. See the [Public API docs](https://langfuse.com/docs/api-and-data-platform/features/public-api) and [real-time ingestion](https://langfuse.com/integrations/native/opentelemetry.md#real-time-ingestion). ## Authentication Authenticate with the API using [Basic Auth](https://en.wikipedia.org/wiki/Basic_access_authentication), get API keys in the project settings: - username: Langfuse Public Key - password: Langfuse Secret Key ## Exports - OpenAPI spec: https://cloud.langfuse.com/generated/api/openapi.yml - Self-hosted deployments: interactive API reference at `/api/docs` and OpenAPI spec at `/api/openapi.yaml`
*
* The version of the OpenAPI document:
*
* Generated by: https://openapi-generator.tech
*/
use crate::models;
use serde::{Deserialize, Serialize};
/// UpsertLlmConnectionRequest : Request to create or update an LLM connection (upsert)
#[derive(Clone, Default, Debug, PartialEq, Serialize, Deserialize, bon::Builder)]
pub struct UpsertLlmConnectionRequest {
/// Provider name (e.g., 'openai', 'my-gateway'). Must be unique in project, used for upserting.
#[serde(rename = "provider")]
pub provider: String,
#[serde(rename = "adapter")]
pub adapter: models::LlmAdapter,
/// Secret key for the LLM API.
#[serde(rename = "secretKey")]
pub secret_key: String,
/// Custom base URL for the LLM API
#[serde(
rename = "baseURL",
default,
with = "::serde_with::rust::double_option",
skip_serializing_if = "Option::is_none"
)]
pub base_url: Option<Option<String>>,
/// List of custom model names
#[serde(
rename = "customModels",
default,
with = "::serde_with::rust::double_option",
skip_serializing_if = "Option::is_none"
)]
pub custom_models: Option<Option<Vec<String>>>,
/// Whether to include default models. Default is true.
#[serde(
rename = "withDefaultModels",
default,
with = "::serde_with::rust::double_option",
skip_serializing_if = "Option::is_none"
)]
pub with_default_models: Option<Option<bool>>,
/// Extra headers to send with requests
#[serde(
rename = "extraHeaders",
default,
with = "::serde_with::rust::double_option",
skip_serializing_if = "Option::is_none"
)]
pub extra_headers: Option<Option<std::collections::HashMap<String, String>>>,
/// Adapter-specific configuration. Validation rules: - **Bedrock**: Required. Must be `{\"region\": \"<aws-region>\"}` (e.g., `{\"region\":\"us-east-1\"}`) - **OpenAI**: Optional. If provided, must be `{\"useResponsesApi\": <boolean>}` to control whether Langfuse routes calls through OpenAI's Responses API. - **VertexAI**: Optional. If provided, must be `{\"location\": \"<gcp-location>\"}` (e.g., `{\"location\":\"us-central1\"}`) - **Other adapters**: Not supported. Omit this field or set to null.
#[serde(
rename = "config",
default,
with = "::serde_with::rust::double_option",
skip_serializing_if = "Option::is_none"
)]
pub config: Option<Option<std::collections::HashMap<String, serde_json::Value>>>,
}
impl UpsertLlmConnectionRequest {
/// Request to create or update an LLM connection (upsert)
pub fn new(
provider: String,
adapter: models::LlmAdapter,
secret_key: String,
) -> UpsertLlmConnectionRequest {
UpsertLlmConnectionRequest {
provider,
adapter,
secret_key,
base_url: None,
custom_models: None,
with_default_models: None,
extra_headers: None,
config: None,
}
}
}