update_tasks_priority

imerit_ango.sdk.SDK.

update_tasks_priority(project_id, priority, filters)

Update the priority values of selected tasks within your project.

Parameters

• project_id: string

  • The unique identifier for the project. You can find the project ID in the user interface or retrieve it using the list_projects function.

• priority: int

  • The new priority value assigned to the selected tasks.

  • Note: The priority value must be between -1000 and 1000. Higher values indicate higher priority.

• filters: dict, default None

  • A dictionary of filters to specify the tasks to requeue.

    • taskIds: List[str]

      • List of task IDs used to directly update specific tasks.

    • externalIds: List[str]

      • List of external IDs used to directly update specific assets.

    • assetIds: List[str]

      • List of asset IDs used to directly update specific assets.

    • batches: List[str]

      • List of batch IDs used to filter tasks belonging to specific batches.

    • fromStageIds: List[str]

      • List of workflow stage IDs used to filter tasks currently located in specific stages.

Returns:

• output: dict

  • A dictionary containing the result of the operation.

  • Including a status field indicating whether the request was successful and a data field containing the response payload with updated resources produced by the operation.

How to verify in Ango Hub?

After successfully executing the update_tasks_priority function, you can validate the changes directly in Ango Hub.

Navigate to: Projects → [Your Project] → Tasks

• Ensure that the "Priority" column is enabled from the Columns dropdown.

• Filter the relevant tasks as needed.

• Verify that the priority values are correctly assigned to each task.

Changes made via the SDK are reflected in Ango Hub in near real-time. If updates are not immediately visible, please refresh the page.

Example

python

import os
from dotenv import load_dotenv
from imerit_ango.sdk import SDK

load_dotenv('variables.env')
api_key = os.getenv('API_KEY')
project_id = os.getenv('PROJECT_ID')

ango_sdk = SDK(api_key)

sdk_response = ango_sdk.update_tasks_priority(
    project_id=project_id,
    priority=15,
    filters={"externalIds": ["image-1.jpg", "image-2.jpg"]}
)

curl

See also

get_tasks, get_assets