Ghost Release: 2.14.2

TL;DR

Ghost 2.14.2 is a maintenance release that focuses on API improvements, bug fixes, and code cleanup. It addresses validation errors when editing posts with relative image URLs and fixes errors when inserting non-existent related tags. The update also includes significant API refinements by removing unused fields from responses, adding JSON Schema validations for tags endpoints, and introducing a new config endpoint for the Member API.

Highlight of the Release

• Fixed validation error when editing posts with relative image URLs
• Fixed error when inserting non-existent related tags
• Added JSON Schema validations for /tags endpoints
• Removed unused fields from Admin API v2 responses
• Added new config endpoint to Member API

Migration Guide

API Changes to Be Aware Of

If you're using the Admin API v2, be aware that several unused fields have been removed from responses:

• tag.parent has been removed (was unused)
• ghost_auth_id has been removed (was unused)
• Several other unused fields have been removed from API responses

If your custom themes, plugins, or integrations rely on any of these fields, you'll need to update your code accordingly.

Client Credentials Changes

Client credentials have been removed from Admin API v2 with exceptions for scheduler & backup clients. If you have integrations that rely on client credentials with the Admin API v2, you'll need to update your authentication approach.

Upgrade Recommendations

This is a minor maintenance release that fixes important bugs related to content editing. We recommend all Ghost users upgrade to version 2.14.2, especially if you:

1. Work with posts containing relative image URLs
2. Use tag management features extensively
3. Have custom integrations with the Admin API

The upgrade should be straightforward with no breaking changes for most users, though developers with custom integrations should review the API changes.

Bug Fixes

Fixed Post Editing Issues

• Fixed validation error when editing a post with relative image URLs, allowing content editors to use relative paths without encountering errors
• Fixed error when inserting non-existent related tags by adding an additional check for the presence of the 'name' property before generating a 'slug'
• Fixed tests for post input serialization by moving config-related variables into function scope so they can be reset by unit tests
• Fixed build issues introduced by previous commit (e47d1e275ffaf88d83abce199ac8d1efa729a001)

New Features

New Config Endpoint for Member API

A new config endpoint has been added to the Member API, improving integration capabilities for membership and subscription features:

• Added getPublicConfig method to stripe payment processor
• Added getPublicConfig method to subscriptions service
• Added initial config endpoint for members API
• Added getConfig method to members gateway

JSON Schema Validations for Tags

Added JSON Schema validations for /tags endpoints to improve data validation and error handling:

• Added JSON Schemas for POST/PUT /tags endpoints
• Added 'strip' keyword definition schema allowing to strip data without throwing errors
• Updated posts JSON Schema with 'strip' properties for ignored attributes
• Relaxed 'uri' format to 'uri-reference'
• Made input array for posts more restrictive

Security Updates

No specific security fixes were mentioned in this release.

Performance Improvements

API Response Optimization

The Admin API v2 responses have been optimized by removing unused fields, resulting in cleaner and more efficient API responses:

• Removed tag.parent field (unused, may be reconsidered if nested tags are implemented)
• Removed ghost_auth_id field (unused authentication field)
• Removed several other unused fields that were unnecessarily exposed
• Updated product hashseed to be hardcoded for more consistent behavior

Impact Summary

Ghost 2.14.2 is primarily a maintenance and bug fix release that improves the stability and reliability of the platform, particularly for content editors. The fixes for validation errors when working with relative image URLs and related tags will result in a smoother content creation experience.

For developers, the API improvements provide cleaner responses by removing unused fields and adding better validation through JSON Schema. The new config endpoint for the Member API enhances integration capabilities for membership and subscription features.

While this release doesn't introduce major new features, it represents important under-the-hood improvements that enhance Ghost's reliability and developer experience. The removal of unused fields from API responses and addition of JSON Schema validations align with Ghost's ongoing efforts to provide a more consistent and predictable API.

Full Release Notes