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

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

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