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

# developerConnectionUpdate

> Change a developer connection's name or settings. Returns null when the store has no connection with that id. Errors with CONNECTION_INVALID when a setting fails its rules, such as a base URL on another host.

**Required scopes:** [`developer_write`](https://developers.redo.com/docs/api-reference/v3/reference/scopes#scope-developer_write)

## Arguments

**id** `ID!` *required*

The connection's `id`.

**input** `[DeveloperConnectionUpdateInput!](/docs/api-reference/v3/reference/developer/developer-connection-update-input)` *required*

The changes.

**fields**

**http** `[HttpDeveloperConnectionUpdateInput](/docs/api-reference/v3/reference/developer/http-developer-connection-update-input)`

HTTP settings to change.

**fields**

**baseUrl** `String`

A new base URL on the same host, such as another path. The host can't change, so the secret is never sent somewhere it wasn't entered for; create a new connection instead.

**headerName** `String`

A new header name, for the HEADER scheme.

**username** `String`

A new username, for the BASIC scheme.

**name** `String`

A new name.

## Returns

**developerConnectionUpdate** `[DeveloperConnection](/docs/api-reference/v3/reference/developer/developer-connection)`

A saved address and secret that automations use to call another service, from Developer › Connections. The secret is write-only: no field returns it, and `secretSet` says whether one is stored.

**fields**

**createdAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the connection was created.

**id** `ID!` *required*

The id of this connection. An HTTP request step names it as its connection.

**lastError** `String`

Why the last request through the connection failed. Null when it succeeded or none was sent.

**lastUsedAt** `[DateTime](/docs/api-reference/v3/reference/common/date-time)`

When an automation last sent a request through the connection. Null when none has.

**name** `String!` *required*

The connection's name, unique in the store.

**secretSet** `Boolean!` *required*

Whether a secret is stored. Requests through a connection without one fail.

**type** `[DeveloperConnectionType!](/docs/api-reference/v3/reference/developer/developer-connection-type)` *required*

What the connection connects to.

**updatedAt** `[DateTime!](/docs/api-reference/v3/reference/common/date-time)` *required*

When the connection's name, settings or secret last changed.

**Possible types:** [`HttpDeveloperConnection`](https://developers.redo.com/docs/api-reference/v3/reference/developer/http-developer-connection)

## Example

```graphql theme={null}
mutation {
  developerConnectionUpdate(id: "...", input: { ... }) {
    createdAt
    id
    lastError
    lastUsedAt
    name
    secretSet
    type
    updatedAt
  }
}
```


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