---
title: "Reorder social links"
method: PUT
path: "/v1/account/social-links/reorder"
tags: ["profiles"]
---

# Reorder social links

`PUT /v1/account/social-links/reorder`

Reorder the authenticated user's social links.

Accepts an ordered list of platform names. The first platform in the list
will appear first on the profile, the second will appear second, etc.

Platforms not included in the list will appear after the explicitly ordered ones.

Authentication: `Authorization: Bearer <CLIENT_JWT>`

## Headers

- `authorization` string, nullable — Bearer JWT issued by Grove that identifies the account.

## Request body

- SocialLinkReorderRequest — Request model for PUT /v1/account/social-links/reorder.
  - `platforms` string[], required — Ordered list of platform names. First item = top of profile.

## Response `200`

Successful Response

- SocialLinkResponse[]
  - `id` string, required — Identity ID for the social link
  - `platform` string, required — Platform name
  - `url` string, required — Full URL to the social profile
  - `verified` boolean — Whether ownership has been verified
  - `verified_at` string, nullable — When ownership was verified (ISO 8601)
  - `verification_method` string, nullable — How ownership was verified (e.g., oauth_youtube)
  - `created_at` string, required — When the link was added (ISO 8601)
  - `display_name` string, nullable — Display name from the platform profile

## Other responses

- `401` — Missing or invalid JWT
- `422` — Validation Error

---

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