Struct Post 

pub struct Post {

    pub id: String,
    pub uuid: Option<String>,
    pub slug: String,
    pub comment_id: Option<String>,
    pub title: String,
    pub lexical: Option<String>,
    pub html: Option<String>,
    pub excerpt: Option<String>,
    pub custom_excerpt: Option<String>,
    pub status: PostStatus,
    pub visibility: Option<String>,
    pub email_only: Option<bool>,
    pub created_at: Option<String>,
    pub updated_at: Option<String>,
    pub published_at: Option<String>,
    pub feature_image: Option<String>,
    pub feature_image_alt: Option<String>,
    pub feature_image_caption: Option<String>,
    pub featured: Option<bool>,
    pub tags: Option<Value>,
    pub authors: Option<Value>,
    pub primary_author: Option<Value>,
    pub primary_tag: Option<Value>,
    pub newsletter: Option<Value>,
    pub email: Option<Value>,
    pub url: Option<String>,
    pub canonical_url: Option<String>,
    pub meta_title: Option<String>,
    pub meta_description: Option<String>,
    pub og_image: Option<String>,
    pub og_title: Option<String>,
    pub og_description: Option<String>,
    pub twitter_image: Option<String>,
    pub twitter_title: Option<String>,
    pub twitter_description: Option<String>,
    pub codeinjection_head: Option<String>,
    pub codeinjection_foot: Option<String>,
    pub custom_template: Option<String>,
}

A Ghost post/article.

Represents a post with all its metadata, content, and relationships. Posts can contain Lexical JSON content or HTML, along with extensive metadata for SEO, social sharing, and organization.

Required Fields

Only title is required when creating a new post. The Ghost API will generate IDs, slugs, and timestamps automatically.

Field Details

• Identifiers: id, uuid, slug, comment_id
• Content: title, lexical, html, excerpt, custom_excerpt
• Status: status, visibility, email_only
• Timestamps: created_at, updated_at, published_at
• Media: feature_image, feature_image_alt, feature_image_caption
• Flags: featured
• Relationships: tags, authors, primary_author, primary_tag, newsletter
• SEO: meta_title, meta_description, canonical_url, url
• Social: og_* (Open Graph), twitter_* (Twitter Cards)
• Code Injection: codeinjection_head, codeinjection_foot, custom_template

Example

use ghost_io_api::models::post::{Post, PostStatus};
use serde_json::json;

let json = json!({
    "id": "5ddc9141c35e7700383b2937",
    "title": "Welcome",
    "slug": "welcome-short",
    "status": "published",
    "visibility": "public",
    "created_at": "2019-11-26T02:43:13.000Z",
    "published_at": "2019-11-26T02:44:17.000Z"
});

let post: Post = serde_json::from_value(json).unwrap();
assert_eq!(post.title, "Welcome");
assert_eq!(post.status, PostStatus::Published);
assert!(post.is_published());

Fields

id: String

Unique post ID (24-character hex string).

uuid: Option<String>

UUID of the post (RFC 4122).

slug: String

URL-friendly identifier (unique, auto-generated from title).

comment_id: Option<String>

ID used for Disqus/comment systems (typically same as id).

title: String

Post title (required on create).

lexical: Option<String>

Rich text content in Lexical JSON format.

html: Option<String>

Rendered HTML content (read-only, use ?formats=html).

excerpt: Option<String>

Auto-generated excerpt from content.

custom_excerpt: Option<String>

Custom excerpt/summary (overrides auto-generated).

status: PostStatus

Publication status: draft, published, scheduled, or sent.

visibility: Option<String>

Who can see the post: “public”, “members”, “paid”, “tiers”.

email_only: Option<bool>

If true, post is sent as email only (no web post).

created_at: Option<String>

When the post was created (ISO 8601).

updated_at: Option<String>

When the post was last updated (ISO 8601).

published_at: Option<String>

When the post was/will be published (ISO 8601).

feature_image: Option<String>

URL to the feature image.

feature_image_alt: Option<String>

Alt text for the feature image (accessibility).

feature_image_caption: Option<String>

Caption for the feature image.

featured: Option<bool>

Whether this post is featured/highlighted.

tags: Option<Value>

Associated tags (array of tag objects or strings).

authors: Option<Value>

Post authors (array of author objects or email strings).

primary_author: Option<Value>

Primary author object.

primary_tag: Option<Value>

Primary tag object.

newsletter: Option<Value>

Newsletter this post belongs to.

email: Option<Value>

Email send metadata (for posts sent as emails).

url: Option<String>

Public URL of the post (read-only).

canonical_url: Option<String>

Override canonical URL for SEO.

meta_title: Option<String>

Custom meta title for <title> tag.

meta_description: Option<String>

Custom meta description for <meta name="description">.

og_image: Option<String>

Custom Open Graph image URL.

og_title: Option<String>

Custom Open Graph title.

og_description: Option<String>

Custom Open Graph description.

twitter_image: Option<String>

Custom Twitter Card image URL.

twitter_title: Option<String>

Custom Twitter Card title.

twitter_description: Option<String>

Custom Twitter Card description.

codeinjection_head: Option<String>

Custom HTML injected into <head> (Ghost Admin only).

codeinjection_foot: Option<String>

Custom HTML injected before </body> (Ghost Admin only).

custom_template: Option<String>

Custom theme template name to use for rendering.

Implementations

impl Post

pub fn is_published(&self) -> bool

Returns true if the post is published.

Example

use ghost_io_api::models::post::{Post, PostStatus};

let mut post = Post::default();
post.status = PostStatus::Published;
assert!(post.is_published());

pub fn is_draft(&self) -> bool

Returns true if the post is a draft.

Example

use ghost_io_api::models::post::{Post, PostStatus};

let mut post = Post::default();
post.status = PostStatus::Draft;
assert!(post.is_draft());

pub fn is_scheduled(&self) -> bool

Returns true if the post is scheduled for future publication.

Example

use ghost_io_api::models::post::{Post, PostStatus};

let mut post = Post::default();
post.status = PostStatus::Scheduled;
assert!(post.is_scheduled());

pub fn is_sent(&self) -> bool

Returns true if the post was sent as an email newsletter.

Example

use ghost_io_api::models::post::{Post, PostStatus};

let mut post = Post::default();
post.status = PostStatus::Sent;
assert!(post.is_sent());

pub fn is_featured(&self) -> bool

Returns true if the post is featured.

Example

use ghost_io_api::models::post::Post;

let mut post = Post::default();
post.featured = Some(true);
assert!(post.is_featured());

pub fn is_email_only(&self) -> bool

Returns true if the post is email-only (no web post).

Example

use ghost_io_api::models::post::Post;

let mut post = Post::default();
post.email_only = Some(true);
assert!(post.is_email_only());

Trait Implementations

impl Clone for Post

fn clone(&self) -> Post

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Post

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for Post

fn default() -> Post

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for Post

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for Post

impl PartialEq for Post

fn eq(&self, other: &Post) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl Serialize for Post

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for Post