ghost-admin-api-html-source

Fix Ghost Admin API posts by passing source=html as a query parameter.

Updated Jan 23, 2026
One-click install
npx skills add https://github.com/strataga/claude-skill-inception --skill ghost-admin-api-html-source
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ghost-admin-api-html-source
Source: https://github.com/strataga/claude-skill-inception/tree/main/ghost-admin-api-html-source
Command: npx skills add https://github.com/strataga/claude-skill-inception --skill ghost-admin-api-html-source

SYSTEM DOCUMENTATION & REQUIREMENTS

## What problem does it solve? Ghost Admin API posts can render without HTML content when HTML is included in the request body. This Skill explains and fixes the issue by instructing developers to pass source=html as a query parameter on POST/PUT requests to preserve HTML content.

## Core Features & Use Cases

  • Diagnose when HTML content is stripped from Ghost Admin API posts.
  • Instruct how to apply the correct query parameter strategy for create and update operations.
  • Provide concrete examples and verification steps to ensure the HTML content is saved and retrievable.

### Quick Start

  1. Use POST /ghost/api/admin/posts/?source=html to create posts with HTML content.
  2. Include the HTML in the request body as the html field.
  3. Verify by fetching the post with formats=html and confirming the HTML content is non-empty.

Frequently Asked Questions about ghost-admin-api-html-source

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
Why does HTML content disappear when I create posts using the Ghost Admin API?

HTML content disappears from Ghost Admin API posts because the API requires source=html as a query parameter rather than including the source field in the JSON body. Appending ?source=html to POST or PUT requests ensures your HTML content is preserved and saved correctly.

How do I format Ghost Admin API requests to save HTML content correctly?

To save HTML content via the Ghost Admin API, send a POST or PUT request to the posts endpoint with ?source=html appended to the URL. Include your HTML payload in the html field of the JSON body, and omit the source field from the body entirely.

Can I include the source parameter in the JSON body when posting to Ghost?

No, including the source parameter in the JSON body does not work for Ghost Admin API requests. You must pass source=html as a URL query parameter on your POST or PUT requests to ensure the API recognizes and saves the HTML content from your request body.

How do I verify that HTML content was successfully saved in Ghost?

Verify saved HTML content by fetching the post from the Ghost Admin API using the formats=html query parameter. Check the response to confirm the html field is non-empty, which indicates the HTML source was successfully stored during your initial POST or PUT request.

When do I need to use the source=html query parameter for Ghost posts?

You need to use the source=html query parameter whenever you are creating or updating Ghost Admin API posts with HTML content. It is required if your HTML is present in the request body but fails to save, ensuring the API processes the raw HTML correctly instead of stripping it out.