Get endpoint connection by ID

Get a specific endpoint connection by ID. See Endpoint Connections.

GET /endpointConnections/{id}

Get endpoint connection by ID

cURL

curl --request GET \
  --url https://api.galtea.ai/endpointConnections/{id} \
  --header 'Authorization: Bearer <token>'

import requests

url = "https://api.galtea.ai/endpointConnections/{id}"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.galtea.ai/endpointConnections/{id}', 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/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.galtea.ai/endpointConnections/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.galtea.ai/endpointConnections/{id}")
  .header("Authorization", "Bearer <token>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.galtea.ai/endpointConnections/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body

200

{
  "productId": "prod_123",
  "name": "My API Connection",
  "url": "https://api.example.com/v1/chat/completions",
  "httpMethod": "POST",
  "authType": "BEARER",
  "inputTemplate": "{\"prompt\": \"{{ input.user_message }}\"}",
  "outputMapping": {
    "output": "$.choices[0].message.content"
  },
  "id": "ec_123",
  "userId": "user_123",
  "hasAuthToken": true,
  "username": "<string>",
  "hasPassword": true,
  "headers": {
    "Content-Type": "application/json"
  },
  "inputSchema": {
    "type": "object",
    "properties": {
      "user_message": {
        "type": "string",
        "description": "The main user message to the agent"
      },
      "reasoning_level": {
        "type": "string",
        "enum": [
          "low",
          "medium",
          "high"
        ],
        "description": "How much reasoning the agent should apply"
      },
      "topic": {
        "type": "string",
        "enum": [
          "billing",
          "shipping",
          "returns",
          "account"
        ],
        "description": "Conversation topic"
      },
      "customer_id": {
        "type": "string",
        "pattern": "^C-\\d{3,6}$",
        "description": "Customer identifier"
      }
    },
    "required": [
      "user_message"
    ]
  },
  "type": "CONVERSATION",
  "timeout": 15,
  "rateLimit": 60,
  "retryEnabled": true,
  "retryMaxAttempts": 1,
  "retryInitialDelayMs": 1000,
  "retryBackoffStrategy": "EXPONENTIAL",
  "retryMaxDelayMs": 3000,
  "retryableStatusCodes": [
    429,
    500,
    502,
    503,
    504
  ],
  "createdAt": "2023-11-07T05:31:56Z",
  "deletedAt": "2023-11-07T05:31:56Z"
}

{
  "error": "Error type",
  "message": "Error message description"
}

{
  "error": "Error type",
  "message": "Error message description"
}

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-....

Path Parameters

id · string · required

EndpointConnection ID

Response

200

application/json

Endpoint connection retrieved successfully

productId · string · required

Example:

"prod_123"

name · string · required

Example:

"My API Connection"

url · string · required

Example:

"https://api.example.com/v1/chat/completions"

httpMethod · enum<string> · required

Available options: GET, POST, PUT, PATCH, DELETE

Example:

"POST"

authType · enum<string> · required

Available options: NONE, BEARER, API_KEY, BASIC

Example:

"BEARER"

inputTemplate · string | null · required

Jinja2/Nunjucks template for request body. Must contain {{ input.user_message }} placeholder.

Example:

"{\"prompt\": \"{{ input.user_message }}\"}"

outputMapping · object | null · required

JSONPath expressions to extract values from API response. Must include "output" key.

Show child attributes

Example:

{ "output": "$.choices[0].message.content" }

id · string

Example:

"ec_123"

userId · string | null

Example:

"user_123"

hasAuthToken · boolean

Whether an auth token is configured (token value is not exposed)

username · string | null

Username for Basic auth

hasPassword · boolean

Whether a password is configured (password value is not exposed)

headers · object | null

Show child attributes

Example:

{ "Content-Type": "application/json" }

inputSchema · object | null

Optional JSON Schema (draft 2020-12) defining the structure of input fields, their types, and valid values. Must have type "object" with a "properties" key.

Example:

{
  "type": "object",
  "properties": {
    "user_message": {
      "type": "string",
      "description": "The main user message to the agent"
    },
    "reasoning_level": {
      "type": "string",
      "enum": ["low", "medium", "high"],
      "description": "How much reasoning the agent should apply"
    },
    "topic": {
      "type": "string",
      "enum": ["billing", "shipping", "returns", "account"],
      "description": "Conversation topic"
    },
    "customer_id": {
      "type": "string",
      "pattern": "^C-\\d{3,6}$",
      "description": "Customer identifier"
    }
  },
  "required": ["user_message"]
}

type · enum<string>

Available options: INITIALIZATION, CONVERSATION, FINALIZATION

Example:

"CONVERSATION"

timeout · integer | null · default: 15

Per-attempt request timeout in seconds. Unset applies the default (15). Capped server-side at 120 seconds.

Required range: 1 <= x <= 120

Example:

15

rateLimit · integer | null

Maximum requests per minute. Unset (null) means no rate limit.

Required range: x >= 1

Example:

60

retryEnabled · boolean · default: true

Whether automatic retry is enabled for failed requests

retryMaxAttempts · integer | null · default: 1

Maximum number of retry attempts (applied when retryEnabled is true). 0 is only valid when retryEnabled is false; with retry enabled the minimum is 1.

Required range: 0 <= x <= 10

retryInitialDelayMs · integer | null · default: 1000

Initial delay in milliseconds before first retry

Required range: x >= 0

retryBackoffStrategy · enum<string> | null · default: EXPONENTIAL

Strategy for increasing delay between retries

Available options: FIXED, EXPONENTIAL, LINEAR

retryMaxDelayMs · integer | null · default: 3000

Maximum delay between retry attempts, in milliseconds. Capped server-side at 60000 (60 seconds) to bound retry blast radius.

Required range: 0 <= x <= 60000

retryableStatusCodes · integer[]

HTTP status codes that should trigger a retry

Required range: 100 <= x <= 599

createdAt · string<date-time>

deletedAt · string<date-time> | null