Introduction
Searching for assets is a fundamental operation in digital asset management workflows. Whether you’re managing a large library of assets or collaborating with a team, being able to efficiently locate and filter assets is crucial. This guide demonstrates how to use the Mudstack API to search for assets, filter them by library, and filter by review status. By following these examples, you can streamline your workflows and improve productivity. These examples are designed for developers integrating Mudstack into their applications or automation scripts. They demonstrate how to:- Search for assets using the
/workspaces/assets/search
endpoint. - Filter assets by library, specifically finding the library named “Ready for engine”.
- Filter assets where the
reviewStatus
is “rejected”.
Before Starting: Authenticate and Retrieve an Authorization Token
Use the/auth/token
endpoint to retrieve an authorization token. Replace <your_account_id>
, <your_key>
, and <your_secret>
with your account ID, API key, and secret, respectively.
Examples
Example 1: Search for Assets by Query
Use the/workspaces/assets/search
endpoint to search for assets by a specific query. Replace <your_key>
, <your_secret>
, <workspace_id>
, and <account_id>
with your API key, secret, workspace ID, and account ID, respectively.
Example 2: Filter Assets by Library
To filter assets by library, first retrieve all libraries using the/workspaces/libraries
endpoint. Then, find the library with the name “Ready for engine” and use its id
to filter assets.
Example 3: Filter Assets by Review Status
Filter assets where thereviewStatus
is “rejected” using the /workspaces/assets/search
endpoint.