---
title: "List editorials"
method: GET
path: "/v1/admin/editorials"
tags: ["Admin Editorials"]
---

# List editorials

`GET /v1/admin/editorials`

## Request

- Base URL: `https://api.hify.club`
- URL: `https://api.hify.club/v1/admin/editorials`
- Auth: API key in header `X-User-Token`

Returns editorials newest first, paginated. Total counts are returned in the X-Total-Count and X-Total-Pages response headers.

## Query parameters

- `page` integer
- `per_page` integer

## Response `200`

Editorials

- Editorial[]
  - `id` integer
  - `title` string
  - `caption` string, nullable
  - `boosted` boolean: Pins the post to page 1 of the explore feed.
  - `position` integer, nullable: Ordering among boosted posts; unset positions sort last.
  - `expires_at` string, date-time, nullable: Set to retire a post; unset or future means active.
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `media` EditorialMedia[]
    - `id` integer
    - `editorial_id` integer
    - `position` integer: Order of the asset within the editorial.
    - `media_type` string: Kind of asset.
    - `s3_bucket` string
    - `s3_path` string: Bare object key; the CDN host carries the folder segment.
    - `thumbnail_s3_path` string, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time

## Other responses

- `401`: Unauthenticated
- `403`: Forbidden - caller is not an admin

---

[API](https://skmtc.dev/hify/apis/hify-apis.md) - [All operations](https://skmtc.dev/hify/apis/hify-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/hify/apis/hify-apis/revisions/b5920403538d?raw)