Returns
Returns the updated Endpoint Connection object.Example
Parameters
string
required
ID of the endpoint connection to update.
string
New name for the endpoint connection.
string
New endpoint URL. For multi-step session lifecycles, supports a
{{ session_id }} placeholder (requires an INITIALIZATION endpoint).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.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.string
New authentication token.
string
New username for
BASIC authentication.string
New password for
BASIC authentication.dict[string, string]
New custom headers. Replaces the whole map. Supports credential placeholders (e.g.,
{{ bearer_token }}, {{ api_key }}). A fetched connection returns each secret header value as ••••••••: send that value back to keep the stored value, or send a new value to replace it. See Secret Header Values.string
New input template with Jinja2 placeholders. Keep
{{ input_files[0].url }} or {{ input_files[0].base64 }} in the template if your test cases attach files, because a run over those test cases is refused without it. See Input Template.dict[string, string]
New output mapping using JSONPath expressions. See Output Mapping.
int
New per-attempt request timeout in seconds. Capped at
120; values above this are rejected by the API.int
New maximum requests per minute. Pass
None for no limit.bool
Whether automatic retry is enabled. See Retry Configuration.
int
New maximum retry attempts (0–10).
0 is only valid when retry is disabled; with retry enabled the minimum is 1.int
New initial delay in milliseconds before first retry.
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.int
New maximum delay between retry attempts, in milliseconds. Capped at
60000; values above this are rejected.list[int]
New HTTP status codes that trigger retry. Each value must be a valid HTTP status code (100–599).
bool
Set to
true to accept an http:// URL. Required when url is not HTTPS, unless the deployment allows plain HTTP for every connection. See HTTP Endpoints.list[ConversationEndRule]
New list of replies that mean your agent ended the conversation. It replaces the stored list; pass an empty list to remove every rule. Each
ConversationEndRule has a status_code (100–599) and an optional body_match (ConversationEndBodyMatch with path and equals). A 2xx rule needs a body_match. At most 20 rules, and only for CONVERSATION type. See Conversation End Rules.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.auth_token and password are the exception: None or an empty string keeps the stored credential. To remove one, change auth_type, which clears the credentials the new type does not use.