PATCH
/
cms
/
v3
/
blogs
/
posts
/
{objectId}
/
draft
Update the draft of a post
curl --request PATCH \
  --url https://api.hubapi.com/cms/v3/blogs/posts/{objectId}/draft \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "publishDate": "2023-11-07T05:31:56Z",
  "language": "af",
  "enableLayoutStylesheets": true,
  "metaDescription": "<string>",
  "attachedStylesheets": [
    {}
  ],
  "password": "<string>",
  "htmlTitle": "<string>",
  "publishImmediately": true,
  "translations": {},
  "id": "<string>",
  "state": "<string>",
  "slug": "<string>",
  "createdById": "<string>",
  "rssBody": "<string>",
  "currentlyPublished": true,
  "archivedInDashboard": true,
  "created": "2023-11-07T05:31:56Z",
  "contentTypeCategory": "0",
  "mabExperimentId": "<string>",
  "updatedById": "<string>",
  "translatedFromId": "<string>",
  "folderId": "<string>",
  "widgetContainers": {},
  "pageExpiryRedirectId": 123,
  "dynamicPageDataSourceType": 123,
  "featuredImage": "<string>",
  "authorName": "<string>",
  "domain": "<string>",
  "name": "<string>",
  "dynamicPageHubDbTableId": "<string>",
  "campaign": "<string>",
  "dynamicPageDataSourceId": "<string>",
  "enableDomainStylesheets": true,
  "includeDefaultCustomCss": true,
  "layoutSections": {},
  "updated": "2023-11-07T05:31:56Z",
  "footerHtml": "<string>",
  "tagIds": [
    123
  ],
  "widgets": {},
  "postSummary": "<string>",
  "headHtml": "<string>",
  "pageExpiryRedirectUrl": "<string>",
  "abStatus": "master",
  "useFeaturedImage": true,
  "abTestId": "<string>",
  "featuredImageAltText": "<string>",
  "blogAuthorId": "<string>",
  "contentGroupId": "<string>",
  "rssSummary": "<string>",
  "pageExpiryEnabled": true,
  "url": "<string>",
  "enableGoogleAmpOutputOverride": true,
  "publicAccessRules": [
    {}
  ],
  "archivedAt": 123,
  "postBody": "<string>",
  "themeSettingsValues": {},
  "pageExpiryDate": 123,
  "publicAccessRulesEnabled": true,
  "currentState": "AUTOMATED",
  "categoryId": 123,
  "linkRelCanonicalUrl": "<string>"
}'
{
  "publishDate": "2023-11-07T05:31:56Z",
  "language": "af",
  "enableLayoutStylesheets": true,
  "metaDescription": "<string>",
  "attachedStylesheets": [
    {}
  ],
  "password": "<string>",
  "htmlTitle": "<string>",
  "publishImmediately": true,
  "translations": {},
  "id": "<string>",
  "state": "<string>",
  "slug": "<string>",
  "createdById": "<string>",
  "rssBody": "<string>",
  "currentlyPublished": true,
  "archivedInDashboard": true,
  "created": "2023-11-07T05:31:56Z",
  "contentTypeCategory": "0",
  "mabExperimentId": "<string>",
  "updatedById": "<string>",
  "translatedFromId": "<string>",
  "folderId": "<string>",
  "widgetContainers": {},
  "pageExpiryRedirectId": 123,
  "dynamicPageDataSourceType": 123,
  "featuredImage": "<string>",
  "authorName": "<string>",
  "domain": "<string>",
  "name": "<string>",
  "dynamicPageHubDbTableId": "<string>",
  "campaign": "<string>",
  "dynamicPageDataSourceId": "<string>",
  "enableDomainStylesheets": true,
  "includeDefaultCustomCss": true,
  "layoutSections": {},
  "updated": "2023-11-07T05:31:56Z",
  "footerHtml": "<string>",
  "tagIds": [
    123
  ],
  "widgets": {},
  "postSummary": "<string>",
  "headHtml": "<string>",
  "pageExpiryRedirectUrl": "<string>",
  "abStatus": "master",
  "useFeaturedImage": true,
  "abTestId": "<string>",
  "featuredImageAltText": "<string>",
  "blogAuthorId": "<string>",
  "contentGroupId": "<string>",
  "rssSummary": "<string>",
  "pageExpiryEnabled": true,
  "url": "<string>",
  "enableGoogleAmpOutputOverride": true,
  "publicAccessRules": [
    {}
  ],
  "archivedAt": 123,
  "postBody": "<string>",
  "themeSettingsValues": {},
  "pageExpiryDate": 123,
  "publicAccessRulesEnabled": true,
  "currentState": "AUTOMATED",
  "categoryId": 123,
  "linkRelCanonicalUrl": "<string>"
}
Supported products
Requires one of the following products or higher.
Marketing HubMarketing HubProfessional
Sales HubSales HubFree
Service HubService HubFree
Content HubContent HubStarter

​
Required Scopes

This API requires one of the following scopes:
  • content

Authorizations

​
Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Path Parameters

​
objectId
string
required

The ID of the blog post to update the draft of.

Body

application/json

The JSON representation of the updated Blog Post to be applied to the draft.

Model definition for a Blog Post.

Response

200
application/json

successful operation

Model definition for a Blog Post.