Blog posts

Unpublish a blog post

Changed on

Reverts a published post to a draft, removing it from the public board. Takes no request body. The stored publishedAt is preserved so a later republish keeps the original publish date.

post/blog/posts/{id}/unpublish

Request

  • Base URL: https://api.cavuno.com/v1
  • URL: https://api.cavuno.com/v1/blog/posts/{id}/unpublish
  • Auth: HTTP bearer

Path parameters

idstring required

The post's opaque object id: the id field returned by the blog-post endpoints (e.g. b3p8m2k7d9q4x0r5t1v6w8y2z7a4c0n3). This is NOT the slug or title; passing a slug like my-first-post returns 404. To look up a post by title or slug, use GET /v1/blog/posts or POST /v1/blog/posts/search and read the returned id.

Response

Successful response.

idstring required

Unique identifier for the object. Use this value as the {id} path parameter for the blog-post endpoints (e.g. GET /v1/blog/posts/{id}).

object'blog_post' required
titlestring required
slugstring required
statusstring required
visibilitystring required
typestring required
featuredboolean required
authorIdsstring[] required
tagIdsstring[] required
coverUrlstring nullable required
ogImageUrlstring nullable required
featureImageAltstring nullable required
featureImageCaptionstring nullable required
customExcerptstring nullable required
readingTimeMinnumber nullable required
seoTitlestring nullable required
seoDescriptionstring nullable required
canonicalUrlstring nullable required
publishedAtstring nullable required
createdAtstring required
updatedAtstring nullable required
htmlstring nullable required

Changes

  • c34152c38176Revision changes
    • info

      added the optional property / to the response with the status

    • info

      added the optional property / to the response with the status