upload_files

imerit_ango.sdk.SDK.

upload_files(project_id, file_paths, storage_id, batches, priority)

Upload local files to 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.

• file_paths: List[str]

  • A list containing absolute paths to files and, optionally, their contextData.

  • Example:

[
    {
        "data": "/Users/lorenzo/Desktop/Gassino,_arrival_of_tramway_auto_x2.jpg",
        "metadata": {
            "width": 1500,
            "height": 1200
        },
        "contextData": {
            "key1": "value1"
        }
    }
]

• storage_id: string, Optional, default None

  • This parameter has no function anymore and will be deprecated in the next version of the SDK.

• batches: List[str], Optional, default None

  • You may assign the files you are uploading to one or more batches that exist in your project by providing their IDs here. You may create new batches with create_batch and you can get a list of batches with get_batches.

  • Example: ['0000000aa0a00a0000aaaa0a', '0000000aa0a00a0000aaaa0b']

• priority: int, Optional, default 0

  • The new priority value to assign to the uploaded assets.

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

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.

The SDK does not set a separate maximum number of files for one upload_files call. Imports are still subject to your organization asset quota and project-level asset limits. For very large imports, split files across multiple smaller calls.

The upload_files function is supported only for Ango projects. Local file uploads are disabled for PCT projects, please use the upload_files_cloud function instead.

How to verify in Ango Hub?

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

Navigate to: Projects → [Your Project] → Asset

• Ensure that all assets have been successfully imported and are visible in the project.

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

Importing two local files:

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)

files = ["data/my_image_1.png", "data/my_image_2.png"]
ango_sdk.upload_files(project_id=project_id, file_paths=files)

Importing a file with a custom external ID:

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)

files = [{"data": "data/my_image_1.png", "externalId": "custom_external_id"}]
ango_sdk.upload_files(project_id=project_id, file_paths=files)

See also

upload_files_cloud, upload_files_with_asset_builder