ATatlassian
Custom Content

Create custom content

Creates a new custom content in the given space, page, blogpost or other custom content.

Only one of spaceId, pageId, blogPostId, or customContentId is required in the request body. Permissions required: Permission to view the content of the page or blogpost and its corresponding space. Permission to create custom content in the space.

post/custom-content

Request

  • Base URL
    https://no-default/wiki/api/v2
  • URL
    https://no-default/wiki/api/v2/custom-content
  • Auth
    • HTTP basic
    • or OAuth 2
      Authorization code: https://auth.atlassian.com/authorize
      Token URL: https://auth.atlassian.com/oauth/token scopes: write:custom-content:confluence

Request body

typestring required

Type of custom content.

status'current' | 'draft'

The status of the custom content. Defaults to current when status not provided.

spaceIdstring

ID of the containing space.

pageIdstring

ID of the containing page.

blogPostIdstring

ID of the containing Blog Post.

customContentIdstring

ID of the containing custom content.

titlestring required

Title of the custom content.

Response

Returned if the requested custom content is created successfully.

idstring

ID of the custom content.

typestring

The type of custom content.

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

The status of the content.

titlestring

Title of the custom content.

spaceIdstring

ID of the space the custom content is in.

Note: This is always returned, regardless of if the custom content has a container that is a space.

pageIdstring

ID of the containing page.

Note: This is only returned if the custom content has a container that is a page.

blogPostIdstring

ID of the containing blog post.

Note: This is only returned if the custom content has a container that is a blog post.

customContentIdstring

ID of the containing custom content.

Note: This is only returned if the custom content has a container that is custom content.

authorIdstring

The account ID of the user who created this custom content originally.

createdAtstring date-time

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

Changes

No recorded changes to this operation across all 5 revisions of this API.