---
title: "Update external link"
method: PUT
path: "/properties-api/listing-settings/external-links/{propertyId}/{linkId}"
tags: ["Listing external links"]
---

# Update external link

`PUT /properties-api/listing-settings/external-links/{propertyId}/{linkId}`

Updates URL and/or display name of one link. Include only the fields you want to change (url, name, or both). linkId is from the list (GET) or a create response.

## Path parameters

- `propertyId` string, required
- `linkId` string, required

## Request body

- object
  - `url` string, uri — New URL for the link. Omit to leave unchanged. Must include protocol if set.
  - `name` string — New display name. Omit to leave unchanged. 1–500 characters if set.

## Response `200`

The updated link (id, url, name).

- object
  - `id` string, required — Unique id of the link. Use for update (PUT :propertyId/:linkId), delete (DELETE), or reorder (PUT :propertyId/order).
  - `url` string, required — URL of the link (with protocol).
  - `name` string, required — Display name shown to users.

## Other responses

- `400` — Body validation failed: url must be a valid URL with protocol (e.g. https://); name 1–500 characters if provided.
- `401` — Missing or invalid authentication. Account ID is required.
- `403` — You do not have permission to perform this action on the property.
- `404` — No external link exists for this property with the given link ID.

---

[API](https://skmtc.net/guesty/apis/guesty-open-api.md) · [All operations](https://skmtc.net/guesty/apis/guesty-open-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/guesty/guesty-open-api/versions/7c62644070f2/schema)