---
search:
  tags:
    - Ops
    - POST
seo:
  description: >-
    Admin only. Writes one published changelog entry and records the caller as
    its… Reference for the POST /api/v1/changelog endpoint in the PharmaFlow
    API.
sidebar:
  label: Publish a changelog entry
  badge: POST
title: Publish a changelog entry
type: openapi-operation
---
Admin only. Writes one published changelog entry and records the caller as its author. Only the title is required, and the entry is published at once for the next release screen.

`POST /api/v1/changelog`

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

- `title` (string, required)
- `version` (string)
- `category` (string)
- `body` (string)

Request body example:

```json
{
  "title": "string",
  "version": "string",
  "category": "string",
  "body": "string"
}
```

**Responses**

- `201` — Changelog entry published
- `400` — title is required
- `401` — Not authenticated
- `403` — Caller is not an admin

Response example, 201:

```json
{
  "id": "string",
  "version": "string",
  "category": "string",
  "title": "string",
  "body": "string",
  "published": -9007199254740991,
  "published_at": "string",
  "created_by": "string",
  "created_at": "string"
}
```