Confluence Cloud icon

Confluence Cloud

Access to the Confluence Cloud REST API - Auto-generated from OpenAPI

Overview

The "Get Space Content Labels" operation in the Label resource retrieves labels associated with content (such as pages, blog posts, etc.) within a specific Confluence space. This is useful for categorizing or filtering content based on labels applied in that space.

Typical use cases include:

  • Fetching all labels used in a particular space to understand how content is tagged.
  • Filtering or organizing content by label prefixes or sorting labels alphabetically.
  • Integrating with other workflows that require metadata about content labeling in Confluence spaces.

For example, a user might want to get all labels starting with "team" in a project space to generate reports or automate content management tasks.

Properties

Name Meaning
Id The ID of the space for which labels should be returned.
Return All Whether to return all results or only up to a given limit.
Limit Maximum number of results to return (API limit: 250).
Additional Fields Optional filters and sorting options:
- Prefix: Filter labels by prefix ("My", "Team").
- Sort: Sort results by a specified field.

Output

The output JSON contains a list of label objects under the results property. Each label object represents a label applied to content within the specified space.

The structure typically includes:

  • Label name
  • Possibly additional metadata depending on API response

If the Return All option is enabled, all matching labels are returned; otherwise, the number of labels is limited by the Limit property.

No binary data is output by this operation.

Dependencies

  • Requires an authenticated connection to the Confluence Cloud REST API.
  • An API key credential or equivalent authentication token must be configured in n8n credentials.
  • The base URL for the Confluence instance must be set in the node's credentials.

Troubleshooting

  • Permission Errors: If the user lacks permission to view the space, the API will return an error. Ensure the API token has sufficient permissions to access the target space.
  • Invalid Space ID: Providing an incorrect or non-existent space ID will result in no labels being returned or an error.
  • Limit Exceeded: The API limits the maximum number of results to 250 per request. Use the Return All option to paginate through all results.
  • Prefix Filtering: Using an invalid prefix value may return no results. Use one of the allowed prefix options ("My", "Team") or leave empty for no prefix filter.

Links and References

Discussion