Returns
Returns the updated Endpoint Connection object.Example
Parameters
New endpoint URL. A URL of another origin (scheme, host, or port) clears the stored
auth_token, password, and secret header values. Send the new auth_token or password in the same request when the auth_type needs one, or the API answers 400. 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 authentication token. Required with a
url of another origin when auth_type is BEARER or API_KEY.New password for
BASIC authentication. Required with a url of another origin when auth_type is BASIC.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. After a url of another origin, send the new value: the stored secret header values are cleared, so the API answers 400 to the mask. 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. The API refuses a filter expression such as
[?(...)]. 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. A url of another origin also clears them, so send the new value in the same request.