​
Introduction

Efficiently managing tasks and their associated assets is a critical requirement in workflows involving digital asset management systems. This guide demonstrates how to automate the process of finding tasks with a status that is not “Completed” and retrieving their corresponding assets by their IDs. By following these examples, you can streamline your task and asset management processes and integrate them into your existing workflows. Authentication is a critical step in interacting with the Mudstack API. Each request requires an authorization token, which is obtained using your API key and secret. Additionally, the x-workspace-id and x-account-id headers must be included in every request to ensure proper scoping. This example is particularly useful for scenarios such as:
  • Identifying tasks that require immediate attention.
  • Automating the retrieval of assets associated with pending tasks.
  • Integrating task and asset management with other systems or workflows.
This example demonstrates how to:
  1. Authenticate and retrieve an authorization token.
  2. Retrieve tasks using the /tasks endpoint.
  3. Filter tasks with a status that is not “Completed”.
  4. Retrieve the corresponding assets for the filtered tasks using the /workspaces/assets/{asset_id} endpoint.

​
Steps

​
Step 1: 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. 
# Python example to retrieve an authorization token
import requests

url = "https://api.mudstack.com/auth/token"
headers = {
    "x-account-id": "<your_account_id>",
    "Content-Type": "application/json"
}
data = {
    "key": "<your_key>",
    "secret": "<your_secret>"
}
response = requests.post(url, headers=headers, json=data)
token = response.json()["token"]
print(token)
Response Example: 
{
  "token": "your_generated_token"
}

​
Step 2: Retrieve Tasks

Use the /tasks endpoint to retrieve tasks. Replace <your_token>, <workspace_id>, and <account_id> with your authorization token, workspace ID, and account ID, respectively. 
# Python example to retrieve tasks
import requests

url = "https://api.mudstack.com/tasks"
headers = {
    "Authorization": "Bearer <your_token>",
    "x-workspace-id": "<workspace_id>",
    "x-account-id": "<account_id>"
}
response = requests.get(url, headers=headers)
tasks = response.json()["tasks"]
print(tasks)
Response Example: 
{
  "tasks": [
    {
      "id": "task1",
      "status": "Pending",
      "asset_id": "asset1"
    },
    {
      "id": "task2",
      "status": "Completed",
      "asset_id": "asset2"
    }
  ]
}

​
Step 3: Filter Tasks with Status Not “Completed”

Filter the tasks to exclude those with a status of “Completed”. 
// Filter tasks with status not "Completed"
const filteredTasks = tasks.filter(task => task.status !== "Completed");

​
Step 4: Retrieve Corresponding Assets

For each filtered task, retrieve the corresponding asset using the /workspaces/assets/{asset_id} endpoint. 
# Python example to retrieve assets
for task in filtered_tasks:
    url = f"https://api.mudstack.com/workspaces/assets/{task['asset_id']}"
    headers = {
        "Authorization": "Bearer <your_token>",
        "x-workspace-id": "<workspace_id>",
        "x-account-id": "<account_id>"
    }
    response = requests.get(url, headers=headers)
    print(response.json())
Response Example: 
{
  "id": "asset1",
  "name": "example_asset.png",
  "status": "Pending"
}

​
Explore More Examples

Looking for more examples? Check out the following guides to learn about other use cases: