Skip to main content
Changelogs

Delete a changelog

Deletes a changelog by its unique identifier.

DELETE
/v2/changelogs/{id}

Deletion Behavior

The changelog and all associated comments are permanently deleted. This action cannot be undone.

Permissions

Only organization admins can delete changelogs.

Response

Returns a deletion confirmation:

{
  "id": "6457e3ff70afca5d8c27dccc",
  "object": "changelog",
  "deleted": true
}

Errors

  • 400 - Invalid changelog ID format
  • 404 - Changelog not found or doesn't belong to your organization
Authorizationstringheaderrequired

API key as Bearer token. Use: Authorization: Bearer sk_...

idstringrequired

Changelog unique identifier

Example: 507f1f77bcf86cd799439011
Featurebase-Versionenum<string>header

API version for this request. Defaults to your organization's configured API version if not specified.

Available options: 2026-08-19.orbit, 2026-01-01.nova, 2025-12-12.clover
Example: 2026-08-19.orbit

Response

application/json

Success

deletedenum<boolean>required

Indicates the resource was deleted

Available options: true
Example: true
idstringrequired

Unique identifier of the deleted changelog

Example: 507f1f77bcf86cd799439011
objectenum<string>required

Object type identifier

Available options: changelog
Example: changelog