File pull

File pull service

Provides coroutine-based methods for managing file downloads and uploads within the Norman platform.

The FilePull class handles the submission and retrieval of download metadata and upload links for model-related files such as inputs, outputs, and assets.

get_download_metadata(token, entity_id) async

Coroutine

Retrieve metadata for a specific file download operation.

This method returns download tracking details for inputs, outputs, or assets associated with the provided entity ID.

Parameters

  • token (Sensitive[str]) — Authentication token authorizing the request.

  • entity_id (str) — The unique identifier of the entity (input, output, or asset) whose download metadata should be retrieved.

Response Structure

  • response (TrackedDownloadUnion) — Union type containing metadata for tracked downloads. Includes file size, creation time, type, and download URLs.


submit_asset_links(token, download_request) async

Coroutine

Submit a request to upload or register asset file links for a model.

Parameters

  • token (Sensitive[str]) — Authentication token authorizing the request.

  • download_request (AssetDownloadRequest) — Request object defining asset upload metadata.

Response Structure

  • response (List[str]) — List of successfully registered asset link URLs.


submit_input_links(token, download_request) async

Coroutine

Submit input file links for processing or association with an invocation.

Parameters

  • token (Sensitive[str]) — Authentication token authorizing the request.

  • download_request (InputDownloadRequest) — Request object defining model input upload details.

Response Structure

  • response (List[str]) — List of input upload URLs or references created by the system.

submit_output_links(token, download_request) async

Coroutine

Submit output file links for an invocation or job.

Parameters

  • token (Sensitive[str]) — Authentication token authorizing the request.

  • download_request (OutputDownloadRequest) — Request object containing model output details.

Response Structure

  • response (List[str]) — List of uploaded or registered output link URLs.

·

©

2026