Test connection to Ollama instance

Validates that the provided Ollama URL is reachable. URL may be provided with or without /v1 suffix (e.g., http://localhost:11434 or http://localhost:11434/v1). The /v1 suffix will be automatically removed for connection testing. For inference, use the URL with /v1 suffix.

Request

This endpoint expects an object.

base_urlstringRequired>=1 character

Base URL of the Ollama instance. May include /v1 suffix which will be automatically removed for connection testing. For inference, use the URL with /v1 suffix for OpenAI-compatible endpoints.

api_keystringOptional

Optional API key for authenticated Ollama instances. If provided, will be sent as Bearer token in Authorization header.

Response

Connection test successful

connectedboolean or null

Whether the connection was successful

versionstring or null

Server version (returned even if connection failed or version is incompatible)

error_messagestring or null

Error message if connection failed

1	import requests
2
3	url = "http://localhost:5173/api/v1/private/ollama/test-connection"
4
5	payload = { "base_url": "http://localhost:11434/v1" }
6	headers = {"Content-Type": "application/json"}
7
8	response = requests.post(url, json=payload, headers=headers)
9
10	print(response.json())

Request

Response

Errors