> ## Documentation Index
> Fetch the complete documentation index at: https://docs.galtea.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Update Endpoint Connection

> Update an existing endpoint connection.

> [!WARNING]
>
> You are reading the docs of Galtea 5.14. [Read this page in the latest version](https://docs.galtea.ai/sdk/api/endpoint-connection/update.md).

## Returns

Returns the updated [Endpoint Connection](https://docs.galtea.ai/v5.14/concepts/product/endpoint-connection.md) object.

## Example

```python theme={"system"}
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](https://docs.galtea.ai/v5.14/concepts/product/endpoint-connection.md#multi-step-session-lifecycle-advanced), 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. 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](https://docs.galtea.ai/v5.14/concepts/product/endpoint-connection-configuration.md#secret-header-values).

**input\_template** `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](https://docs.galtea.ai/v5.14/concepts/product/endpoint-connection-configuration.md#input-template).

**output\_mapping** `dict[string, string]`

New output mapping using JSONPath expressions. See [Output Mapping](https://docs.galtea.ai/v5.14/concepts/product/endpoint-connection-configuration.md#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](https://docs.galtea.ai/v5.14/concepts/product/endpoint-connection-configuration.md#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).

**acknowledged\_insecure\_http** `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](https://docs.galtea.ai/v5.14/concepts/product/endpoint-connection.md#http-endpoints).

**conversation\_end\_rules** `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](https://docs.galtea.ai/v5.14/concepts/product/endpoint-connection-configuration.md#conversation-end-rules).

> [!NOTE]
>
> 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.