---
title: "Update Bridge"
method: PATCH
path: "/api/v1/iam/tunnel/bridges/{id}"
tags: ["Tunnel"]
---

# Update Bridge

`PATCH /api/v1/iam/tunnel/bridges/{id}`

UpdateBridge patches a bridge's editable metadata (display_name,
 description). Credentials are not affected.

## Path parameters

- `id` string, required — The id field.

## Request body

- C1ApiIamV1TunnelCredentialsServiceUpdateBridgeRequestInput — The TunnelCredentialsServiceUpdateBridgeRequest message.
  - `description` string — New description. Applied only when "description" is in update_mask. Empty clears the description.
  - `displayName` string — New display name. Applied only when "display_name" is in update_mask. Must be non-empty when applied.
  - `updateMask` string, nullable

## Response `200`

Successful response

- C1ApiIamV1TunnelCredentialsServiceUpdateBridgeResponse — The TunnelCredentialsServiceUpdateBridgeResponse message.
  - `bridge` C1ApiIamV1TunnelBridge — TunnelBridge is the API view of a bridge — the customer-facing entity for managing a wormhole tunnel appliance.
    - `appliance` C1ApiIamV1TunnelAppliance — TunnelAppliance is the live state of the customer-side appliance for one bridge.
      - `announcedServiceCount` integer — Number of services the appliance is currently announcing.
      - `lastSeenAt` string, date-time, nullable
      - `links` C1ApiIamV1TunnelApplianceLink[], nullable — Wormhole relays currently holding a Link for this bridge. Typically of length 1.
        - `avgRtt` string, duration, nullable
        - `leaseExpiresAt` string, date-time, nullable
        - `relayAddress` string — Public address (host:port) of the relay server, suitable for use in client-side connection strings.
        - `relayId` string — Identifier of the wormhole relay server holding this Link.
      - `status` 'TUNNEL_APPLIANCE_STATUS_UNSPECIFIED' | 'TUNNEL_APPLIANCE_STATUS_CONNECTED' | 'TUNNEL_APPLIANCE_STATUS_DISCONNECTED' | 'TUNNEL_APPLIANCE_STATUS_NEVER_CONNECTED' — The status field.
    - `createdAt` string, date-time, nullable
    - `deletedAt` string, date-time, nullable
    - `description` string — The description field.
    - `displayName` string — The displayName field.
    - `id` string — The id field.
    - `updatedAt` string, date-time, nullable

---

[API](https://skmtc.net/conductorone/apis/c1-api.md) · [All operations](https://skmtc.net/conductorone/apis/c1-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductorone/c1-api/revisions/f2cf3228f366/schema)