footer-comments

create-footer-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

Flag	Type	Required	Description
--body	string	No	request body (JSON string, @file, or - for stdin)

Example:

cf footer-comments create-footer-comment

delete-footer-comment

Delete footer comment

Deletes a footer comment. This is a permanent deletion and cannot be reverted.

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

DELETE /footer-comments/{comment-id}

Flag	Type	Required	Description
--comment-id	string	Yes	The ID of the comment to be retrieved.

Example:

cf footer-comments delete-footer-comment --comment-id <comment-id>

get-footer-comment-by-id

Get footer comment by id

Retrieves a footer comment by id

Permissions required: Permission to view the content of the container and its corresponding space.

GET /footer-comments/{comment-id}

Flag	Type	Required	Description
--body-format	string	No	The content format type to be returned in the body field of the response. If available, the representation will be available under a response field of the same name under the body field.
--comment-id	string	Yes	The ID of the comment to be retrieved.
--include-likes	string	No	Includes likes associated with this footer comment in the response.
The number of results will be limited to 50 and sorted in the default sort order.
A meta and _links property will be present to indicate if more results are available and a link to retrieve the rest of the results.
--include-operations	string	No	Includes operations associated with this footer comment in the response, as defined in the Operation object.
The number of results will be limited to 50 and sorted in the default sort order.
A meta and _links property will be present to indicate if more results are available and a link to retrieve the rest of the results.
--include-properties	string	No	Includes content properties associated with this footer comment in the response.
The number of results will be limited to 50 and sorted in the default sort order.
A meta and _links property will be present to indicate if more results are available and a link to retrieve the rest of the results.
--include-version	string	No	Includes the current version associated with this footer comment in the response.
By default this is included and can be omitted by setting the value to false.
--include-versions	string	No	Includes versions associated with this footer comment in the response.
The number of results will be limited to 50 and sorted in the default sort order.
A meta and _links property will be present to indicate if more results are available and a link to retrieve the rest of the results.
--version	string	No	Allows you to retrieve a previously published version. Specify the previous version's number to retrieve its details.

Example:

cf footer-comments get-footer-comment-by-id --comment-id <comment-id>

get-footer-comment-children

Get children footer comments

Returns the children footer comments of specific comment. The number of results is limited by the limit parameter and additional results (if available) will be available through the next URL present in the Link response header.

Permissions required: Permission to view the content of the page and its corresponding space.

GET /footer-comments/{id}/children

Flag	Type	Required	Description
--body-format	string	No	The content format type to be returned in the body field of the response. If available, the representation will be available under a response field of the same name under the body field.
--cursor	string	No	Used for pagination, this opaque cursor will be returned in the next URL in the Link response header. Use the relative URL in the Link header to retrieve the next set of results.
--id	string	Yes	The ID of the parent comment for which footer comment children should be returned.
--limit	string	No	Maximum number of footer comments per result to return. If more results exist, use the Link header to retrieve a relative URL that will return the next set of results.
--sort	string	No	Used to sort the result by a particular field.

Example:

cf footer-comments get-footer-comment-children --id <id>

get-footer-comment-operations

Get permitted operations for footer comment

Returns the permitted operations on specific footer comment.

Permissions required: Permission to view the parent content of the footer comment and its corresponding space.

GET /footer-comments/{id}/operations

Flag	Type	Required	Description
--id	string	Yes	The ID of the footer comment for which operations should be returned.

Example:

cf footer-comments get-footer-comment-operations --id <id>

get-footer-comment-version-details

Get version details for footer comment version

Retrieves version details for the specified footer comment version.

Permissions required: Permission to view the content of the page or blog post and its corresponding space.

GET /footer-comments/{id}/versions/{version-number}

Flag	Type	Required	Description
--id	string	Yes	The ID of the footer comment for which version details should be returned.
--version-number	string	Yes	The version number of the footer comment to be returned.

Example:

cf footer-comments get-footer-comment-version-details --id <id> --version-number <version-number>

get-footer-comment-versions

Get footer comment versions

Retrieves the versions of the specified footer comment.

Permissions required: Permission to view the content of the page or blog post and its corresponding space.

GET /footer-comments/{id}/versions

Flag	Type	Required	Description
--body-format	string	No	The content format types to be returned in the body field of the response. If available, the representation will be available under a response field of the same name under the body field.
--cursor	string	No	Used for pagination, this opaque cursor will be returned in the next URL in the Link response header. Use the relative URL in the Link header to retrieve the next set of results.
--id	string	Yes	The ID of the footer comment for which versions should be returned
--limit	string	No	Maximum number of versions per result to return. If more results exist, use the Link header to retrieve a relative URL that will return the next set of results.
--sort	string	No	Used to sort the result by a particular field.

Example:

cf footer-comments get-footer-comment-versions --id <id>

get-footer-comments

Get footer comments

Returns all footer comments. The number of results is limited by the limit parameter and additional results (if available) will be available through the next URL present in the Link response header.

Permissions required: Permission to view the content of the container and its corresponding space.

GET /footer-comments

Flag	Type	Required	Description
--body-format	string	No	The content format type to be returned in the body field of the response. If available, the representation will be available under a response field of the same name under the body field.
--cursor	string	No	Used for pagination, this opaque cursor will be returned in the next URL in the Link response header. Use the relative URL in the Link header to retrieve the next set of results.
--limit	string	No	Maximum number of footer comments per result to return. If more results exist, use the Link header to retrieve a relative URL that will return the next set of results.
--sort	string	No	Used to sort the result by a particular field.

Example:

cf footer-comments get-footer-comments

get-footer-like-count

Get like count for footer comment

Returns the count of likes of specific footer comment.

Permissions required: Permission to view the content of the page/blogpost and its corresponding space.

GET /footer-comments/{id}/likes/count

Flag	Type	Required	Description
--id	string	Yes	The ID of the footer comment for which like count should be returned.

Example:

cf footer-comments get-footer-like-count --id <id>

get-footer-like-users

Get account IDs of likes for footer comment

Returns the account IDs of likes of specific footer comment.

Permissions required: Permission to view the content of the page/blogpost and its corresponding space.

GET /footer-comments/{id}/likes/users

Flag	Type	Required	Description
--cursor	string	No	Used for pagination, this opaque cursor will be returned in the next URL in the Link response header. Use the relative URL in the Link header to retrieve the next set of results.
--id	string	Yes	The ID of the footer comment for which like count should be returned.
--limit	string	No	Maximum number of account IDs per result to return. If more results exist, use the Link header to retrieve a relative URL that will return the next set of results.

Example:

cf footer-comments get-footer-like-users --id <id>

update-footer-comment

Update footer comment

Update a footer comment. This can be used to update the body text of a comment.

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

PUT /footer-comments/{comment-id}

Flag	Type	Required	Description
--body	string	No	request body (JSON string, @file, or - for stdin)
--comment-id	string	Yes	The ID of the comment to be retrieved.

Example:

cf footer-comments update-footer-comment --comment-id <comment-id>