v1

latestOpenAPI 3.0.32026-07-13218142597.2 KB
Blog Post

Create blog post

Creates a new blog post in the space specified by the spaceId.

By default this will create the blog post as a non-draft, unless the status is specified as draft. If creating a non-draft, the title must not be empty.

Currently only supports the storage representation specified in the body.representation enums below

post/blogposts

Query parameters

privateboolean

The blog post will be private. Only the user who creates this blog post will have permission to view and edit one.

Request body

spaceIdstring required

ID of the space

status'current' | 'draft'

The status of the blog post, specifies if the blog post will be created as a new blog post or a draft

titlestring

Title of the blog post, required if creating non-draft.

createdAtstring

Created date of the blog post in the format of "yyyy-MM-ddTHH:mm:ss.SSSZ".

Response

Returned if the blog post was created successfully.

idstring

ID of the blog post.

status'current' | 'draft' | 'historical' | 'trashed' | 'deleted' | 'any'

The status of the content.

titlestring

Title of the blog post.

spaceIdstring

ID of the space the blog post is in.

authorIdstring

The account ID of the user who created this blog post originally.

createdAtstring date-time

Date and time when the blog post was created. In format "YYYY-MM-DDTHH:mm:ss.sssZ".

isFavoritedByCurrentUserboolean

Whether the blog post has been favorited by the current user.