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

# Reorder external links

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

Sets the display order of links. Send linkIds in the order you want (first id = first link). Only the ids you send are moved to the top in that order; any other links for the property stay at the bottom unchanged. All ids must exist for this property; no duplicates. Use GET to obtain current ids.

## Path parameters

- `propertyId` string, required

## Request body

- object
  - `linkIds` string[], required — Link ids in the order you want them to appear. These move to the top; other links for the property stay at the bottom. All ids must exist for this property; no duplicates. Get ids from GET :propertyId.

## Response `200`

Full list of external links for the property in the new order.

- 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` — linkIds contains an id that does not exist for this property, or contains duplicates.
- `401` — Missing or invalid authentication. Account ID is required.
- `403` — You do not have permission to perform this action on the property.

---

[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/revisions/7c62644070f2/schema)