Update Endpoint Connection

Update an existing endpoint connection.

Returns

Returns the updated Endpoint Connection object.

Example

endpoint_connection = galtea.endpoint_connections.update(
    endpoint_connection_id=endpoint_connection_id,
    timeout=60,
    rate_limit=100,
)

Parameters

endpoint_connection_id · string · required

ID of the endpoint connection to update.

name · string

New name for the endpoint connection.

url · string

New endpoint URL. For multi-step session lifecycles, supports a {{ session_id }} placeholder (requires an INITIALIZATION endpoint).

http_method · string

New HTTP method. Valid values: GET, POST, PUT, PATCH, DELETE. Other string values are sent to the API unchanged, so values added in newer API versions can be used; the API rejects invalid ones.

auth_type · string

New authentication type. Valid values: NONE, BEARER, API_KEY, BASIC. Other string values are sent to the API unchanged, so values added in newer API versions can be used; the API rejects invalid ones.

auth_token · string

New authentication token.

username · string

New username for BASIC authentication.

password · string

New password for BASIC authentication.

headers · dict[string, string]

New custom headers. Supports credential placeholders (e.g., {{ bearer_token }}, {{ api_key }}). See Custom Headers.

input_template · string

New input template with Jinja2 placeholders. See Input Template.

output_mapping · dict[string, string]

New output mapping using JSONPath expressions. See Output Mapping.

timeout · int

New per-attempt request timeout in seconds. Capped at 120; values above this are rejected by the API.

rate_limit · int

New maximum requests per minute. Pass None for no limit.

retry_enabled · bool

Whether automatic retry is enabled. See Retry Configuration.

retry_max_attempts · int

New maximum retry attempts (0–10). 0 is only valid when retry is disabled; with retry enabled the minimum is 1.

retry_initial_delay_ms · int

New initial delay in milliseconds before first retry.

retry_backoff_strategy · string

New backoff strategy. Valid values: FIXED, EXPONENTIAL, LINEAR. Other string values are sent to the API unchanged, so values added in newer API versions can be used; the API rejects invalid ones.

retry_max_delay_ms · int

New maximum delay between retry attempts, in milliseconds. Capped at 60000; values above this are rejected.

retryable_status_codes · list[int]

New HTTP status codes that trigger retry. Each value must be a valid HTTP status code (100–599).

All fields except endpoint_connection_id default to PydanticUndefined (from pydantic_core). Omit a field (or pass PydanticUndefined) to leave it unchanged. Pass None to explicitly clear an optional field. Pass a value to update it.