Actions43
- Space Actions
- Page Actions
- Template Actions
- Search Actions
- Comment Actions
- Get Page Footer Comments
- Get Page Inline Comments
- Get Blog Post Footer Comments
- Get Blog Post Inline Comments
- Get Custom Content Comments
- Get Footer Comments
- Create Footer Comment
- Get Footer Comment By Id
- Update Footer Comment
- Delete Footer Comment
- Get Footer Comment Children
- Get Inline Comments
- Create Inline Comment
- Get Inline Comment By Id
- Update Inline Comment
- Delete Inline Comment
- Get Inline Comment Children
- Label Actions
Overview
This node operation retrieves the labels associated with a specific blog post in Confluence Cloud. It is useful when you want to fetch metadata tags (labels) that categorize or describe a blog post, which can help in organizing content, filtering posts by topics, or automating workflows based on label data.
Common scenarios:
- Automatically gathering all labels of a blog post to display or process them elsewhere.
- Filtering or tagging blog posts in external systems based on their Confluence labels.
- Integrating Confluence blog post metadata into reporting or content management pipelines.
Example:
You have a blog post with ID 12345 and want to get all its labels to sync with another system or to analyze the tags used across your blog posts.
Properties
| Name | Meaning |
|---|---|
| Id | The numeric ID of the blog post for which labels should be returned. |
| Return All | Boolean flag indicating whether to return all labels or limit the number of results. |
| Limit | Maximum number of label results to return if "Return All" is false. Max allowed is 250. |
| Additional Fields | Optional filters and sorting options: |
| - Prefix | Filter labels by prefix. Options: My, Team, Global, System. |
| - Sort | String to specify sorting order of the results. |
Output
The output JSON contains an array of label objects under the results property. Each label object represents a label attached to the specified blog post. The exact structure of each label object depends on the Confluence API but typically includes label name, prefix, and other metadata.
If the "Return All" option is enabled, all labels are returned; otherwise, the number of labels is limited by the "Limit" property.
No binary data is output by this operation.
Dependencies
- Requires access to a Confluence Cloud instance with appropriate permissions.
- Requires an API authentication credential configured in n8n to authorize requests to the Confluence Cloud REST API.
- The node uses the Confluence Cloud REST API endpoint
/wiki/api/v2/blogposts/{id}/labels.
Troubleshooting
- Permission errors: Ensure the API user has permission to view the blog post and its labels.
- Invalid ID: Verify the blog post ID is correct and exists.
- Rate limits: The Confluence API may limit request rates; consider using "Return All" carefully.
- Empty results: If no labels are returned, confirm the blog post actually has labels assigned.
- Sorting/filtering issues: Check that the prefix and sort values are valid as per the API documentation.