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. Without an ID, it needs permission to create one. See Endpoint Connections.

POST /endpointConnections/testConnection

Test endpoint connection

cURL

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": {}
}
'

200

{
  "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>"
}

Authorizations

Authorization · string · header · required

API key authorization. Pass your API key in the Authorization header as a Bearer token. Both new (gsk_*) and legacy (gsk-) API keys are accepted, e.g. Authorization: Bearer gsk_... or Authorization: Bearer gsk-....

Body

application/json

id · string

Optional ID of an existing endpoint connection. When provided, stored connection data is used as base and remaining fields act as overrides.

Example:

"id_123"

url · string

The endpoint URL to test.

Example:

"https://api.example.com"

httpMethod · string

HTTP method (GET, POST, etc.)

authType · string

Authentication type (NONE, BEARER, API_KEY, BASIC)

authToken · string

Authentication token (for BEARER or API_KEY). With an ID, a blank value (null or empty string) keeps the stored token, and the token is dropped when authType changes to NONE or BASIC.

username · string

Username (for BASIC auth)

password · string

Password (for BASIC auth). With an ID, a blank value (null or empty string) keeps the stored password, and the password is dropped when authType changes to NONE, BEARER or API_KEY.

Example:

"securePass123!"

headers · object

Custom headers as key-value pairs. With an ID, a value of "••••••••" (the masked value a read returns) sends the stored value of that header name. Without an ID, or for a header with no stored value, "••••••••" is a 400. A value in the stored ciphertext shape is a 400.

inputTemplate · string

Input template with Jinja2 placeholders

timeout · number

Request timeout in seconds

acknowledgedInsecureHttp · boolean

Required true to test an http:// URL. With an ID, the stored value applies when omitted. It is ignored for an https:// URL.

outputMapping · object

JSONPath expressions applied to a successful response. The result is returned in extractedOutput. It is not read from the stored connection.

Show child attributes

Response

200

application/json

Test connection result

success · boolean · required

statusCode · integer · required

latency · number · required

response · object

The endpoint response. Each inline file payload that output_files matched is replaced by a placeholder such as <base64, 1.2 MB>. The bytes of a file a run would store are in extractedOutput.output_files. A refused payload is not echoed.

error · string

extractedOutput · object

The output mapping applied to a successful response. Absent when no mapping was sent.

Show child attributes

extractionError · string

Why the output mapping could not be applied.