Retrieves metadata taxonomy nodes based on the specified parameters. Use when you need to browse or search hierarchical metadata classifications in Box. Results are sorted in lexicographic order unless a query parameter is passed, in which case results are sorted by relevance.
levelarrayFilters results by taxonomy level. Multiple values can be provided. Results include nodes that match any of the specified values.
limitintegerThe maximum number of items to return per page.
querystringQuery text to search for the taxonomy nodes. When specified, results are sorted by relevance instead of lexicographic order.
markerstringDefines the position marker at which to begin returning results. This is used when paginating using marker-based pagination. This requires usemarker to be set to true.
parentarrayNode identifier of a direct parent node. Multiple values can be provided. Results include nodes that match any of the specified values.
ancestorarrayNode identifier of any ancestor node. Multiple values can be provided. Results include nodes that match any of the specified values.
namespaceRequiredstringThe namespace of the metadata taxonomy. Typically starts with 'enterprise_' followed by your enterprise ID.
taxonomy_keyRequiredstringThe key of the metadata taxonomy. This is the unique identifier for the taxonomy template.
include-total-result-countbooleanWhen set to true, provides the total number of nodes that matched the query. The response will compute counts of up to 10,000 elements. Defaults to false.
dataRequiredData from the action execution
errorstringError if any occurred during the execution of the action
successfulRequiredbooleanWhether or not the action execution was successful or not
OAuth connection. Risk level 2 of 5.
Free Action
No published Skills explicitly reference this Action yet.