---
title: "Create or update a changelog entry by slug"
method: POST
path: "/api/admin/changelog"
tags: ["Admin"]
---

# Create or update a changelog entry by slug

`POST /api/admin/changelog`

## Request

- Base URL: `https://app.d-sports.org`
- URL: `https://app.d-sports.org/api/admin/changelog`
- Auth: HTTP bearer

Platform moderator/admin only. `slug` plus any subset of entry fields. A complete body (kind, version, dateLabel, title, sections) creates the slug when absent — 201 on create, 200 on re-save; a partial body updates an existing entry only (VALIDATION_ERROR when absent). `tags` accepts the client wire shape — plain labels or `{label, platform?}` objects; `sections`/`bullets` are validated the same way. A write never touches `status`/`publishedAt` — publish separately.

## Request body

- object
  - `slug` string, required
  - `kind` 'STORE_RELEASE' | 'OTA_UPDATE': STORE_RELEASE ships no updateIds; OTA_UPDATE requires at least one on create (merged pair is checked on partial writes).
  - `version` string: Client-facing app/build version, e.g. `1.31.0`.
  - `updateIds` string[]: Expo/EAS update ids this entry covers (OTA_UPDATE only).
  - `dateLabel` string: Verbatim display label, e.g. `October 2026` — not a timestamp.
  - `title` string
  - `titlePlatform` 'ios' | 'android' | 'all', nullable: Audience override for the heading line.
  - `platform` 'ios' | 'android' | 'all', nullable: Audience filter for the whole entry; `null`/`all` = every client.
  - `tags` union[]
    - union
      - string
      - object
        - `label` string, required
        - `platform` 'ios' | 'android' | 'all'
  - `sections` object[]
    - `heading` string
    - `body` string
    - `platform` 'ios' | 'android' | 'all'
    - `bullets` union[]
      - union
        - string
        - object
          - `text` string, required
          - `platform` 'ios' | 'android' | 'all'

## Response `200`

{ success, data: AdminChangelogEntry } — an existing entry was updated.

## Other responses

- `201`: { success, data: AdminChangelogEntry } — the entry was created.
- `400`: { success: false, error, code: "VALIDATION_ERROR" }
- `401`: Not authenticated
- `403`: { success: false, error, code: "FORBIDDEN" }

## Changes

- **2026-11-18** `6de639c52609`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/changes/api/admin/changelog/post.md)

---

[API](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api.md) - [All operations](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/llms.txt) - [OpenAPI document](https://skmtc.dev/d-sports-ecosystem/apis/d-sports-api/revisions/63735cf90a04?raw)
