Returns
Returns the updated Endpoint Connection object.Example
Parameters
New endpoint URL. For multi-step session lifecycles, supports a
{{ session_id }} placeholder (requires an INITIALIZATION endpoint).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.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.New custom headers. Replaces the whole map. Supports placeholders: credentials (e.g.,
{{ bearer_token }}, {{ api_key }}) and call values (e.g., {{ trace_id }}, {{ session_id }}). 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.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.New output mapping using JSONPath expressions. See Output Mapping.
New per-attempt request timeout in seconds. Capped at
120; values above this are rejected by the API.Whether automatic retry is enabled. See Retry Configuration.
New maximum retry attempts (0–10).
0 is only valid when retry is disabled; with retry enabled the minimum is 1.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.New maximum delay between retry attempts, in milliseconds. Capped at
60000; values above this are rejected.New HTTP status codes that trigger retry. Each value must be a valid HTTP status code (100–599).
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.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.