The documentation for the Metadata REST API is available here.
When constructing the URL, ensure that you include all required Path and Query parameters as described.
To send a request to the REST endpoint, you must provide at least the following mandatory URL parameters:
-
cql - the search query. For example, metadataset="global.metadataset.exampleset" to find all pages associated with the global set identified by the key “global.metadataset.exampleset.”
-
sort - for instance, content-name-untokenized to sort results by page title.
-
sortdirection - specify either ASCENDING or DESCENDING.
-
pagesize - for example, 10 to retrieve 10 results per page.
In this context, the parameter names are presented in bold, while example values are shown in italic.
In the CQL section of your query, you can filter using any valid CQL expression. This encompasses not only metadata fields or sets but also Confluence Search Fields.
Related Articles
- SubSpace and Metadata Integration
- Query Page Status (Comala Workflows) alongside Metadata
- Import Fails: It is not possible to import metadata from space A into space B
- REST API, common errors and examples:
- Bulk change of global Metadata sets and fields.
- How to show all pages where Metadata field is empty
- We are getting too many Metadata notifications
- Configure the “Search Macro” from “Refined for Confluence” to use page metadata fields as search parameter
- Use status macro for single select values
- Error when I create a new Metadata field