---
title: "Reorder articles"
url: https://docs.gleap.ai/en/reference/rest-api/reorder-helpcenter-articles
method: PUT
path: "/helpcenter/collections/{helpcenterCollectionId}/articles/order"
api: "API Reference"
tag: "Help center articles"
operationId: "ReorderHelpcenterArticles"
updatedAt: "2026-11-01T18:40:15.677Z"
language: en
---

# Reorder articles

`PUT https://api.gleap.io/v3/helpcenter/collections/{helpcenterCollectionId}/articles/order`

Set the order of the articles in a collection. Send every article id in the order they should appear; the server rewrites all of the collection's ranks so the order is exact and stable. Articles left out of the list keep their relative order and follow the listed ones. Returns the collection's articles in their new order.

## Authorization

- `Authorization` (header, required): `Bearer <token>`

## Request body (`application/json`, required)

- `articleIds` (string[], required): The ids of this collection's articles, in the order they should be shown. Articles of the collection that are left out keep their relative order and are appended after the listed ones.

## Example request

```bash
curl --request PUT \
  --url 'https://api.gleap.io/v3/helpcenter/collections/{helpcenterCollectionId}/articles/order' \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "articleIds": [
    "<articleIds>"
  ]
}'
```

## Responses

### 200 (`application/json`)

Ok

```json
[]
```