ATatlassian
Comment

Create footer comment

Create a footer comment.

The footer comment can be made against several locations:

  • at the top level (specifying pageId or blogPostId in the request body)
  • as a reply (specifying parentCommentId in the request body)
  • against an attachment (note: this is different than the comments added via the attachment properties page on the UI, which are referred to as version comments)
  • against a custom content

Permissions required: Permission to view the content of the page or blogpost and its corresponding space. Permission to create comments in the space.

post/footer-comments

Request

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

Request body

blogPostIdstring

ID of the containing blog post, if intending to create a top level footer comment. Do not provide if creating a reply.

pageIdstring

ID of the containing page, if intending to create a top level footer comment. Do not provide if creating a reply.

parentCommentIdstring

ID of the parent comment, if intending to create a reply. Do not provide if creating a top level comment.

attachmentIdstring

ID of the attachment, if intending to create a comment against an attachment.

customContentIdstring

ID of the custom content, if intending to create a comment against a custom content.

Response

Returned if the footer comment is created.

idstring

ID of the comment.

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

The status of the content.

titlestring

Title of the comment.

blogPostIdstring

ID of the blog post containing the comment if the comment is on a blog post.

pageIdstring

ID of the page containing the comment if the comment is on a page.

attachmentIdstring

ID of the attachment containing the comment if the comment is on an attachment.

customContentIdstring

ID of the custom content containing the comment if the comment is on a custom content.

parentCommentIdstring

ID of the parent comment if the comment is a reply.

Changes

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