POST/projects/{project_id}/changelog

Create a changelog entry

Create a hand-authored entry (`source = manual`). Lands as a draft unless `publish` is set. Set `published_at` to backdate entries when importing existing changelog history.

Base URLhttps://seggwat.com/api/v1

Parameters

project_idpathstringrequired

Unique identifier of the project (MongoDB ObjectId)

Example: 507f1f77bcf86cd799439011

Request Body

required

application/json

ChangelogCreateRequest

A new hand-authored entry (`source = manual`).

bodystring

Markdown body.

Default:

categoryanynullable

publishboolean

Publish to the public board immediately instead of landing as a draft.

Default: false

published_atstringnullable

Explicit display date (RFC 3339 or `YYYY-MM-DD`) for importing existing changelog history. Defaults to the publish moment.

Example: 2025-11-03

titlestringrequired

Example: Dark mode

versionstringnullable

Example: v1.4.0

Responses

Request

POST/projects/{project_id}/changelog

curl \
  -X POST \
  "https://seggwat.com/api/v1/projects/string/changelog" \
  -H "Content-Type: application/json" \
  -d '{
  "body": "string",
  "category": "any",
  "publish": true,
  "published_at": "2025-11-03",
  "title": "Dark mode",
  "version": "v1.4.0"
}'

Response

200application/json

{
  "body": "The dashboard and widgets now follow your OS theme.",
  "category": "any",
  "created_at": "string",
  "id": "6630f1c7c2b3a40a1e9e1b33",
  "project_id": "6630f1c7c2b3a40a1e9e1b11",
  "published_at": "string",
  "source": "manual",
  "source_ref": "string",
  "status": "draft",
  "title": "Dark mode",
  "updated_at": "string",
  "version": "v1.4.0"
}

Navigation