v3

latestOpenAPI 3.1.02026-08-045365213.8 KB

Test Provider Connection

Test connection to an LLM provider with given configuration.

This endpoint allows testing a provider configuration before saving it.

post/llm-providers/test-connection

integration_idstring uuid nullable

Unique integration ID (auto-generated)

integration_namestring required

User-friendly name for this integration

providerstring required

LLM provider name (openai, anthropic, custom)

api_keystring nullable required

API key for the provider (null to keep existing when updating)

model_namestring required

Default model name for this integration (required)

base_urlstring nullable

Custom endpoint URL (required for 'custom' provider, null for cloud)

supports_web_searchboolean

Whether model supports web search

input_cost_per_tokennumber nullable

Estimated input token cost for this model

output_cost_per_tokennumber nullable

Estimated output token cost for this model

is_defaultboolean

Whether this is the default provider

model_deprecatedboolean

Whether model is no longer supported and needs updating

Successful Response

messagestring required

Human-readable status message

integration_idstring nullable

Integration ID (present for create/update operations)

status'success' | 'error' nullable

Operation status (for connection tests)

providerstring nullable

Provider name (for connection tests)

models_availablestring[] nullable

Available models (for connection tests)