---
title: "Reorder articles"
method: PUT
path: "/helpcenter/collections/{helpcenterCollectionId}/articles/order"
tags: ["Help center articles"]
---

# Reorder articles

`PUT /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.

## Request body

- HelpcenterArticleOrderDto
  - `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.

## Response `200`

Ok

- HelpcenterArticleDocument[]
  - `updatedAt` string, required
  - `createdAt` string, required
  - `extendedAudienceFilter` unknown
  - `baseAudienceFilter` unknown
  - `docId` number, double
  - `author` object
    - `isValid` object
    - `createFromHexString` object
    - `createFromTime` object
    - `generate` object
    - `cacheHexString` unknown
    - `prototype` string
  - `helpcenterCollection` object
    - `isValid` object
    - `createFromHexString` object
    - `createFromTime` object
    - `generate` object
    - `cacheHexString` unknown
    - `prototype` string
  - `upvotes` unknown
  - `plainContent` unknown
  - `lexorank` string
  - `project` object
    - `isValid` object
    - `createFromHexString` object
    - `createFromTime` object
    - `generate` object
    - `cacheHexString` unknown
    - `prototype` string
  - `externalId` string
  - `content` unknown
  - `title` unknown
  - `description` unknown
  - `sourceUsage` number, double, required
  - `version` number, double, required
  - `isDraft` boolean, required
  - `targetAudience` string, required
  - `tags` string[], required

## Changes

- **2026-08-27** `05e5eb4c2da1` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/gleap/apis/gleap-server/changes/helpcenter/collections/:helpcenterCollectionId/articles/order/put.md)

---

[API](https://skmtc.dev/gleap/apis/gleap-server.md) · [All operations](https://skmtc.dev/gleap/apis/gleap-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gleap/gleap-server/revisions/05e5eb4c2da1/schema)