{ "$schema": "https://json-structure.org/meta/core/v0/#", "$id": "https://raw.githubusercontent.com/api-evangelist/hubspot/refs/heads/main/json-structure/blog-posts-api-version-history-structure.json", "name": "VersionHistory", "description": "Version history entry for a blog post", "type": "object", "properties": { "id": { "type": "string", "description": "Version ID", "example": "500123" }, "object": { "type": "object", "description": "Represents a blog post with all content and metadata", "properties": { "id": { "type": "string", "description": "Unique identifier for the blog post", "example": "500123" }, "name": { "type": "string", "description": "Internal name of the blog post", "example": "Example Record" }, "slug": { "type": "string", "description": "URL slug for the blog post", "example": "example-value" }, "htmlTitle": { "type": "string", "description": "HTML title tag content", "example": "Example Record" }, "postBody": { "type": "string", "description": "HTML content of the blog post body", "example": "This is an example description." }, "postSummary": { "type": "string", "description": "Summary or excerpt of the blog post", "example": "example-value" }, "blogAuthorId": { "type": "string", "description": "ID of the associated blog author", "example": "500123" }, "authorName": { "type": "string", "description": "Display name of the author", "example": "Example Record" }, "contentGroupId": { "type": "string", "description": "ID of the blog this post belongs to", "example": "500123" }, "campaign": { "type": "string", "description": "Campaign GUID associated with the post", "example": "example-value" }, "categoryId": { "type": "int32", "description": "Category ID for the post", "example": 500123 }, "state": { "type": "string", "enum": [ "DRAFT", "DRAFT_AB", "AUTOMATED", "PUBLISHED", "SCHEDULED", "AUTOMATED_DRAFT" ], "description": "Current state of the blog post", "example": "DRAFT" }, "currentState": { "type": "string", "description": "Current state description", "example": "active" }, "publishDate": { "type": "datetime", "description": "ISO 8601 timestamp when the post was/will be published", "example": "2025-03-15T14:30:00Z" }, "created": { "type": "datetime", "description": "ISO 8601 timestamp when the post was created", "example": "2025-03-15T14:30:00Z" }, "updated": { "type": "datetime", "description": "ISO 8601 timestamp when the post was last updated", "example": "2025-03-15T14:30:00Z" }, "archivedAt": { "type": "datetime", "description": "ISO 8601 timestamp when the post was archived", "example": "2025-03-15T14:30:00Z" }, "currentlyPublished": { "type": "boolean", "description": "Whether the post is currently published", "example": true }, "domain": { "type": "string", "description": "Domain where the post is published", "example": "example.hubspot.com" }, "featuredImage": { "type": "string", "description": "URL of the featured image", "example": "example-value" }, "featuredImageAltText": { "type": "string", "description": "Alt text for the featured image", "example": "example-value" }, "metaDescription": { "type": "string", "description": "Meta description for SEO", "example": "This is an example description." }, "headHtml": { "type": "string", "description": "Custom HTML for the head section", "example": "example-value" }, "footerHtml": { "type": "string", "description": "Custom HTML for the footer section", "example": "example-value" }, "language": { "type": "string", "description": "Language code of the blog post", "example": "en" }, "translatedFromId": { "type": "string", "description": "ID of the original post this was translated from", "example": "500123" }, "tagIds": { "type": "array", "items": { "type": "int32" }, "description": "Array of tag IDs associated with the post", "example": [ 500123 ] }, "useFeaturedImage": { "type": "boolean", "description": "Whether to display the featured image", "example": true }, "url": { "type": "uri", "description": "Full URL of the published post", "example": "https://app.hubspot.com/contacts/12345" }, "abStatus": { "type": "string", "enum": [ "master", "variant" ], "description": "A/B test status", "example": "master" }, "abTestId": { "type": "string", "description": "A/B test ID if part of a test", "example": "500123" }, "folderId": { "type": "string", "description": "ID of the folder containing the post", "example": "500123" } }, "required": [ "id", "name", "created", "updated" ] }, "user": { "type": "object", "properties": { "id": { "type": "string" }, "email": { "type": "string" }, "fullName": { "type": "string" } }, "description": "User who made the change", "example": { "id": "500123", "email": "jsmith@example.com", "fullName": "Example Record" } }, "timestamp": { "type": "datetime", "description": "ISO 8601 timestamp of the version", "example": "2025-03-15T14:30:00Z" } } }