Update Blog Post
Update a blog post. Pass the id and only the fields that change. clearImage removes the cover. clearTags removes every tag. useDefaultTemplate clears a custom blog template. archived true removes it from the website; false restores it. Include only fields you want to change; omit the rest. Empty strings, null, and 0 are ignored so they cannot wipe existing values. App connections need the booking:write or inventory:write scope.
curl -X POST "https://dash.lockii.app/api/v1/blog-post/{id}" \
-H "x-api-key: $LOCKII_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"archived": true,
"authorName": "string",
"clearImage": true,
"clearTags": true,
"content": "string",
"excerpt": "string",
"hiddenFromBrowse": true,
"imageID": "string",
"siteTemplatePageID": "string",
"slug": "string",
"tags": [
"string"
],
"title": "string",
"useDefaultTemplate": true
}'Authorization
x-api-keystringheaderAPI key from Settings → Integrations → API.
AuthorizationstringheaderThe same API key, or an OAuth access token, sent as Authorization: Bearer.
api_keystringqueryAPI key query parameter.
Parameters
idstringpathrequiredBlog post id from list_blog_posts or create_blog_post.
Body
archivedbooleanTrue archives the post. False restores an archived post. Omit to leave it unchanged.
authorNamestringAuthor name shown on the article. Omit to leave it blank.
clearImagebooleanTrue removes the cover image. Use this instead of an empty imageID.
clearTagsbooleanTrue removes every tag. Use this instead of an empty tags array.
contentstringArticle body. Simple HTML the editor keeps (p, h2, h3, ul, ol, li, a, strong, em, blockquote) or plain paragraphs separated by a blank line. Do not send markdown. Do not invent an image id inside the HTML.
excerptstringShort summary for cards and search, as plain text. Aim for 140–160 characters when you write one.
hiddenFromBrowsebooleanTrue hides the post from the website. False or omitted keeps it visible.
imageIDstringExisting cover image id. Omit when you do not have one. Do not invent an id.
siteTemplatePageIDstringBlog template page id. Omit to use the company's default blog template.
slugstringPublic URL segment. Omit to generate one from the title.
tagsstring[]Topic tags. On update, this replaces the whole list.
titlestringPost title. Omit to leave it unchanged.
useDefaultTemplatebooleanTrue uses the default blog template.
Response
JSON result for this operation.
{}