curl --request POST \
--url https://api.galtea.ai/endpointConnections/testConnection \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"id": "id_123",
"url": "https://api.example.com",
"httpMethod": "<string>",
"authType": "<string>",
"authToken": "<string>",
"username": "<string>",
"password": "securePass123!",
"headers": {},
"inputTemplate": "<string>",
"timeout": 123,
"acknowledgedInsecureHttp": true,
"outputMapping": {}
}
'import requests
url = "https://api.galtea.ai/endpointConnections/testConnection"
payload = {
"id": "id_123",
"url": "https://api.example.com",
"httpMethod": "<string>",
"authType": "<string>",
"authToken": "<string>",
"username": "<string>",
"password": "securePass123!",
"headers": {},
"inputTemplate": "<string>",
"timeout": 123,
"acknowledgedInsecureHttp": True,
"outputMapping": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
id: 'id_123',
url: 'https://api.example.com',
httpMethod: '<string>',
authType: '<string>',
authToken: '<string>',
username: '<string>',
password: 'securePass123!',
headers: {},
inputTemplate: '<string>',
timeout: 123,
acknowledgedInsecureHttp: true,
outputMapping: {}
})
};
fetch('https://api.galtea.ai/endpointConnections/testConnection', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.galtea.ai/endpointConnections/testConnection",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'id' => 'id_123',
'url' => 'https://api.example.com',
'httpMethod' => '<string>',
'authType' => '<string>',
'authToken' => '<string>',
'username' => '<string>',
'password' => 'securePass123!',
'headers' => [
],
'inputTemplate' => '<string>',
'timeout' => 123,
'acknowledgedInsecureHttp' => true,
'outputMapping' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.galtea.ai/endpointConnections/testConnection"
payload := strings.NewReader("{\n \"id\": \"id_123\",\n \"url\": \"https://api.example.com\",\n \"httpMethod\": \"<string>\",\n \"authType\": \"<string>\",\n \"authToken\": \"<string>\",\n \"username\": \"<string>\",\n \"password\": \"securePass123!\",\n \"headers\": {},\n \"inputTemplate\": \"<string>\",\n \"timeout\": 123,\n \"acknowledgedInsecureHttp\": true,\n \"outputMapping\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.galtea.ai/endpointConnections/testConnection")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"id_123\",\n \"url\": \"https://api.example.com\",\n \"httpMethod\": \"<string>\",\n \"authType\": \"<string>\",\n \"authToken\": \"<string>\",\n \"username\": \"<string>\",\n \"password\": \"securePass123!\",\n \"headers\": {},\n \"inputTemplate\": \"<string>\",\n \"timeout\": 123,\n \"acknowledgedInsecureHttp\": true,\n \"outputMapping\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.galtea.ai/endpointConnections/testConnection")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": \"id_123\",\n \"url\": \"https://api.example.com\",\n \"httpMethod\": \"<string>\",\n \"authType\": \"<string>\",\n \"authToken\": \"<string>\",\n \"username\": \"<string>\",\n \"password\": \"securePass123!\",\n \"headers\": {},\n \"inputTemplate\": \"<string>\",\n \"timeout\": 123,\n \"acknowledgedInsecureHttp\": true,\n \"outputMapping\": {}\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"statusCode": 123,
"latency": 123,
"response": {},
"error": "<string>",
"extractedOutput": {
"output": "<string>",
"retrieval_context": "<string>",
"session_id": "<string>",
"traces": [
{}
],
"metadata": {},
"output_files": [
{
"position": 123,
"kind": "base64",
"filename": "<string>",
"mime_type": "<string>",
"size_bytes": 123,
"host": "<string>",
"base64": "<string>",
"uri": "<string>"
}
],
"output_file_refusals": [
{
"position": 123,
"message": "<string>"
}
]
},
"extractionError": "<string>"
}{
"error": "Error type",
"message": "Error message description"
}{
"error": "Error type",
"message": "Error message description"
}{
"error": "Error type",
"message": "Error message description"
}{
"error": "Error type",
"message": "Error message description"
}Test endpoint connection
Test an endpoint connection by making a sample request. Can be used in two modes: (1) Without an ID — all connection fields are required (creation flow). (2) With an ID — fetches the stored connection and applies any provided fields as overrides (update flow). The two credential fields are the exception: a blank authToken or password keeps the stored one, and changing authType drops the credentials the new type does not use, exactly as saving would. With an ID, the test needs permission to update the connection, whatever the url. While the connection holds a stored secret, a url of another origin (scheme, host or port) is a 400 and nothing is sent, and so is a template tag in the host. The stored URL, or another path on its origin, still works. A stored URL with a template tag in its host has no known origin, so only the identical URL passes. Without an ID, it needs permission to create one. See Endpoint Connections.
curl --request POST \
--url https://api.galtea.ai/endpointConnections/testConnection \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"id": "id_123",
"url": "https://api.example.com",
"httpMethod": "<string>",
"authType": "<string>",
"authToken": "<string>",
"username": "<string>",
"password": "securePass123!",
"headers": {},
"inputTemplate": "<string>",
"timeout": 123,
"acknowledgedInsecureHttp": true,
"outputMapping": {}
}
'import requests
url = "https://api.galtea.ai/endpointConnections/testConnection"
payload = {
"id": "id_123",
"url": "https://api.example.com",
"httpMethod": "<string>",
"authType": "<string>",
"authToken": "<string>",
"username": "<string>",
"password": "securePass123!",
"headers": {},
"inputTemplate": "<string>",
"timeout": 123,
"acknowledgedInsecureHttp": True,
"outputMapping": {}
}
headers = {
"Authorization": "Bearer <token>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
body: JSON.stringify({
id: 'id_123',
url: 'https://api.example.com',
httpMethod: '<string>',
authType: '<string>',
authToken: '<string>',
username: '<string>',
password: 'securePass123!',
headers: {},
inputTemplate: '<string>',
timeout: 123,
acknowledgedInsecureHttp: true,
outputMapping: {}
})
};
fetch('https://api.galtea.ai/endpointConnections/testConnection', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.galtea.ai/endpointConnections/testConnection",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'id' => 'id_123',
'url' => 'https://api.example.com',
'httpMethod' => '<string>',
'authType' => '<string>',
'authToken' => '<string>',
'username' => '<string>',
'password' => 'securePass123!',
'headers' => [
],
'inputTemplate' => '<string>',
'timeout' => 123,
'acknowledgedInsecureHttp' => true,
'outputMapping' => [
]
]),
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>",
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.galtea.ai/endpointConnections/testConnection"
payload := strings.NewReader("{\n \"id\": \"id_123\",\n \"url\": \"https://api.example.com\",\n \"httpMethod\": \"<string>\",\n \"authType\": \"<string>\",\n \"authToken\": \"<string>\",\n \"username\": \"<string>\",\n \"password\": \"securePass123!\",\n \"headers\": {},\n \"inputTemplate\": \"<string>\",\n \"timeout\": 123,\n \"acknowledgedInsecureHttp\": true,\n \"outputMapping\": {}\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Authorization", "Bearer <token>")
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.galtea.ai/endpointConnections/testConnection")
.header("Authorization", "Bearer <token>")
.header("Content-Type", "application/json")
.body("{\n \"id\": \"id_123\",\n \"url\": \"https://api.example.com\",\n \"httpMethod\": \"<string>\",\n \"authType\": \"<string>\",\n \"authToken\": \"<string>\",\n \"username\": \"<string>\",\n \"password\": \"securePass123!\",\n \"headers\": {},\n \"inputTemplate\": \"<string>\",\n \"timeout\": 123,\n \"acknowledgedInsecureHttp\": true,\n \"outputMapping\": {}\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.galtea.ai/endpointConnections/testConnection")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"id\": \"id_123\",\n \"url\": \"https://api.example.com\",\n \"httpMethod\": \"<string>\",\n \"authType\": \"<string>\",\n \"authToken\": \"<string>\",\n \"username\": \"<string>\",\n \"password\": \"securePass123!\",\n \"headers\": {},\n \"inputTemplate\": \"<string>\",\n \"timeout\": 123,\n \"acknowledgedInsecureHttp\": true,\n \"outputMapping\": {}\n}"
response = http.request(request)
puts response.read_body{
"success": true,
"statusCode": 123,
"latency": 123,
"response": {},
"error": "<string>",
"extractedOutput": {
"output": "<string>",
"retrieval_context": "<string>",
"session_id": "<string>",
"traces": [
{}
],
"metadata": {},
"output_files": [
{
"position": 123,
"kind": "base64",
"filename": "<string>",
"mime_type": "<string>",
"size_bytes": 123,
"host": "<string>",
"base64": "<string>",
"uri": "<string>"
}
],
"output_file_refusals": [
{
"position": 123,
"message": "<string>"
}
]
},
"extractionError": "<string>"
}{
"error": "Error type",
"message": "Error message description"
}{
"error": "Error type",
"message": "Error message description"
}{
"error": "Error type",
"message": "Error message description"
}{
"error": "Error type",
"message": "Error message description"
}Authorizations
Body
Response
Test connection result