---
title: "Update an editorial"
method: PATCH
path: "/v1/admin/editorials/{id}"
tags: ["Admin Editorials"]
---

# Update an editorial

`PATCH /v1/admin/editorials/{id}`

## Request

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

Updates an editorial's attributes. If a media array is supplied it replaces the editorial's existing assets rather than diffing them.

## Path parameters

- `id` integer, required

## Request body

- EditorialInput
  - `title` string
  - `caption` string
  - `boosted` boolean
  - `position` integer
  - `expires_at` string, date-time
  - `editor` string: Attributed author recorded in the PaperTrail version.
  - `media` object[]: The full ordered set of assets. Supplying this replaces the editorial's existing media rather than diffing it.
    - `position` integer
    - `media_type` string
    - `s3_bucket` string
    - `s3_path` string
    - `thumbnail_s3_path` string

## Response `200`

Editorial updated

- 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
- `404`: Editorial not found
- `422`: Unprocessable entity - validation failed

---

[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)