Home /Python SDK/Releases

Release notes

Stay updated on the release of new versions of the SDK.

Version release


Check your version

Pip
pip show up42-py
Conda
conda search up42-py

Get the latest version

Pip
pip install up42-py --upgrade
Conda
conda update -c conda-forge up42-py

Only the latest version within a major release is supported. Older minor or patch versions aren’t supported once a newer version is available.

Release tracking in GitHub

  1. Log in into your GitHub account.
  2. Open the repository.
  3. Click Watch inline-icon Watch → Custom.
  4. Select the events you want to subscribe to. To get notifications about releases, select Releases.
  5. Click Apply.

Version history

2025

3.0.0

October 27, 2025
See the migration guide to find replacements for removed methods and properties.

Base functions

  • Removed the get_credits_balance method.

Orders

  • Removed the order_details property.
  • Removed the order_id property.
  • Removed the get_assets method.
  • Removed the track_status method.
  • Removed the initialize_order method.

Catalog base

  • Removed the CatalogBase class.
  • Removed the get_data_product_schema method.
  • Removed the estimate_order method.
  • Removed the place_order method.

Catalog

  • Removed the Catalog class.
  • Removed the construct_search_parameters method.
  • Removed the search method.
  • Removed the construct_order_parameters method.
  • Removed the download_quicklooks method.
  • Removed the initialize_catalog method.

Tasking

  • Removed the Tasking class.
  • Removed the construct_order_parameters method.
  • Removed the get_quotations method.
  • Removed the decide_quotation method.
  • Removed the get_feasibility method
  • Removed the choose_feasibility method.
  • Removed the initialize_tasking method.

Processing templates

  • Removed the DetectionChangeSpacept class.
  • Removed the DetectionChangePleiadesHyperverge class.
  • Removed the DetectionChangeSPOTHyperverge class.

Storage

  • Removed the Storage class.
  • Removed the get_assets method.
  • Removed the get_orders method.
  • Removed the initialize_storage method.

Assets

  • Removed the AssetSorting class.
  • Removed the Asset class.
  • Removed the asset_id property.
  • Removed the stac_items property.
  • Removed the stac_info property.
  • Removed the file property.
  • Removed the get method.
  • Removed the all method.
  • Removed the update_metadata method.
  • Removed the get_stac_asset_url method.
  • Removed the download method.
  • Removed the download_stac_asset method.
  • Removed the initialize_asset method.

Webhooks

  • Removed the Webhook class.
  • Removed the save method.
  • Removed the get method.
  • Removed the trigger_test_events method.
  • Removed the delete method.
  • Removed the get_webhook_events method.
  • Removed the all method.

Tools

  • Removed the Tools class.
  • Removed the read_vector_file method.
  • Removed the get_example_aoi method.
  • Removed the settings method.

Python version

  • Updated the minimum required Python version to 3.10.

2.6.0

September 29, 2025

Processing templates

  • Added a new template: SimularityJobTemplate. It establishes a shared base for Simularity processes, which have source and reference data items.
  • Added a new template: DetectionChangeSimularity.

Orders

  • Added more attributes to TaskingOrderDetails to provide full transparency into the initial order request.

Processing templates

  • Updated the CoregistrationSimularity template to align with the new SimularityJobTemplate.

Glossary

  • Updated the ResolutionValue class by removing the non-functional description field.

Processing templates

  • Marked these change detection processes as deprecated: DetectionChangeSpacept, DetectionChangePleiadesHyperverge, and DetectionChangeSPOTHyperverge. Use DetectionChangeSimularity instead.

2.5.0

August 25, 2025

Processing templates

  • Added a new processing job template: UpsamplingNSSentinel.

Glossary

  • Added default property values to the Provider class to make the internal handling of provider data more resilient.

Data management

  • Added a new BulkDeletion class with a delete method to enable bulk deletion of STAC items by deleting their parent collections.

Processing templates

  • Updated the UpsamplingNS job template to align with the SingleItemJobTemplate, which simplifies its required parameters to just input and title.

Glossary

  • Improved error handling for catalog searches to return actionable messages from the API, making it faster to debug failed requests.

2.4.0

July 21, 2025

Base functions

  • Marked up42.get_credits_balance as deprecated.

Webhooks

  • Marked Webhook.save as deprecated.
  • Marked Webhook.get as deprecated.
  • Marked Webhook.trigger_test_events as deprecated.
  • Marked Webhook.delete as deprecated.
  • Marked Webhook.get_webhook_events as deprecated.
  • Marked Webhook.all as deprecated.

Tasking

  • Added a new FeasibilityStudy class that represents a feasibility study for a tasking order.
  • Added a new FeasibilityStudy.all method that retrieves feasibility studies based on optional filter parameters.
  • Added a new FeasibilityStudy.accept method that selects a feasibility study option for acceptance.
  • Added a new FeasibilityStudy.save method that saves any changes to the decision status of the feasibility study option and updates the properties.
  • Added a new FeasibilityStudySorting class that provides sorting options for feasibility studies.
  • Added a new FeasibilityStudyDecisionOption class that represents the option of the feasibility study that was accepted for a given order.

Additional functionality

  • Added functionality that checks if the latest version of the SDK is used when the package is imported.

Glossary

  • Updated the Scene class to include the provider_properties field.

2.3.1

June 26, 2025

Orders

  • Marked Order.get_assets as deprecated.

STAC

  • Updated Up42ExtensionProperty behavior related to order IDs.

Security

  • Updated requests dependency to version 2.32.4.
  • Updated tornado dependency to version 6.5.1.

2.3.0

June 11, 2025

Assets

  • Marked Asset.all as deprecated.
  • Marked Asset.get as deprecated.
  • Marked Asset.stac_items as deprecated, use pystac.Client.search.
  • Marked Asset.stac_info as deprecated, use pystac.Client.get_item.
  • Marked Asset.file as deprecated, use pystac.Asset.file.

Processing templates

  • Added a new processing job template: CoregistrationSimularity.

2.2.0

May 13, 2025

Assets

  • Marked Asset.asset_id as deprecated, use Asset.id.
  • Marked Asset.update_metadata as deprecated, use pystac.Item.update.
  • Marked Asset.get_stac_asset_url as deprecated, use pystac.Asset.file.url.
  • Marked Asset.download_stac_asset as deprecated, use pystac.Asset.file.download.
  • Marked Asset.download as deprecated, use Asset.file.download.

Catalog

  • Marked Catalog.construct_order_parameters as deprecated, use BatchOrderTemplate.
  • Marked Catalog.construct_search_parameters as deprecated, use Provider.search.
  • Marked Catalog.search as deprecated, use Provider.search.
  • Marked Catalog.download_quicklooks as deprecated, use Scene.quicklook.download.

Catalog base

  • Marked CatalogBase.get_data_product_schema as deprecated, use DataProduct.schema.
  • Marked CatalogBase.estimate_order as deprecated, use BatchOrderTemplate.estimate.
  • Marked CatalogBase.place_order as deprecated, use BatchOrderTemplate.place.

Orders

  • Marked Order.order_id as deprecated, use Order.id.
  • Marked Order.info as deprecated, use Order attributes.
  • Marked Order.order_details as deprecated, use Order.details.
  • Marked Order.track_status as deprecated, use Order.track.
  • Marked Order.estimate as deprecated, use BatchOrderTemplate.estimate.
  • Marked Order.place as deprecated, use BatchOrderTemplate.place.

Storage

  • Marked Storage.get_orders as deprecated, use Order.all.
  • Marked Storage.get_assets as deprecated, use Asset.all.

Tasking

  • Marked Tasking.construct_order_parameters as deprecated, use BatchOrderTemplate.
  • Marked Tasking.get_quotations as deprecated, use Quotation.all.
  • Marked Tasking.decide_quotation as deprecated, use Quotation.accept/Quotation.reject and Quotation.save.
  • Marked Tasking.get_feasibility as deprecated.
  • Marked Tasking.choose_feasibility as deprecated.

up42 namespace

  • Marked up42.initialize_order as deprecated, use Order.get.
  • Marked up42.initialize_catalog as deprecated.
  • Marked up42.initialize_asset as deprecated, use Asset.get.
  • Marked up42.initialize_tasking as deprecated.
  • Marked up42.initialize_storage as deprecated.

Assets

  • Added a new Asset.get method that retrieves an asset by ID.
  • Added a new Asset.all method that filters and iterates assets.

Orders

  • Added a new Order.all method that filters and iterates orders.
  • Added a new Order.get method that retrieves retrieves a specific order by its ID.
  • Added a new order template module (with BatchOrderTemplate and other supporting classes) that unifies data and processing ordering.

Glossary

  • Added a new DataProduct.schema property that returns a JSON representation of the schema for a specific data product.
  • Added a new Provider.search method that filters and iterates scenes of hosting providers using Scene data classes.

Tasking

  • Added a new Quotation class that represents a quotation for a tasking order.
  • Added a new QuotationSorting class that provides sorting options for quotations.

STAC

  • Added a new pystac.Asset.file.url property that provides a signed URL to access the asset without authentication.
  • Added a new pystac.Asset.file.download method that downloads an asset file.
  • Added a new up42 property to pystac.Item and pystac.Collection, this property is a namespace containing all data from UP42 extensions. All properties within this namespace are read-write.
  • Added a new update method to pystac.Item, which saves up42.title and up42.tags values to the service, then updates the item properties based on the response.

Assets

  • Updated Asset and made it a data class.

Orders

  • Updated Order and made it a data class.

Archive

2.1.1

December 12, 2024
  • Updated the endpoint for the get_credits_balance function, migrated from v1 to v2.
  • Removed the limit parameter from the Catalog’s construct_search_parameters functionality, as it’s not intended for user implementation.
  • Removed the DetectionTreesHeightsSpacept processing template class due to the sunsetting of the associated process.

2.1.0

October 9, 2024
  • Supported cost estimation for tasking orders.
  • Supported asset retrieval from orders that have the BEING_FULFILLED status.

2.0.1

August 19, 2024

  • Supported a new Glossary module allowing retrieving information about geospatial collections.

  • Removed the following functions:

    • up42.initialize_webhook. Instead, use up42.Webhook.get.
    • up42.get_webhooks. Instead, use up42.Webhook.all.
    • up42.get_webhook_events. Instead, use up42.Webhook.get_webhook_events.
    • up42.create_webhook. Instead, use webhook.save.
    • Webhook.update. Instead, use webhook.save.
    • Webhook.create. Instead, use webhook.save.
    • CatalogBase.get_collections. Instead, use up42.ProductGlossary.get_collections.
      • Instead of up42.catalog.get_collections, use up42.ProductGlossary.get_collections(collection_type=up42.CollectionType.ARCHIVE).
      • Instead of up42.tasking.get_collections, use up42.ProductGlossary.get_collections(collection_type=up42.CollectionType.TASKING).
    • CatalogBase.get_data_products. Instead, use up42.ProductGlossary.get_collections, it returns data products alongside collection information.

  • Removed the following arguments:

    • In CatalogBase.place_order: scene, geometry.
    • In Catalog.estimate_order: scene, geometry.
    • In Catalog.construct_search_parameters: sortby, ascending.
    • In Storage.get_assets: acquired_after, acquired_before, geometry, custom_filter.
    • In Webhook.all: return_json.

  • Removed the following properties:

    • webhook.webhook_id. Instead, use webhook.id.
    • webhook.info. Instead, use the Webhook object itself.

  • Removed the following classes:

    • In the Catalog class, removed ProductGlossary classes Producer and Host. Replaced by the Provider class in the Glossary module.

  • Removed the following templates:

    • AugmentationSpacept

1.1.1

July 31, 2024
  • Updated versions of Python packages:
    • certifi: updated to version 2024.7.4.
    • setuptools: updated to version 70.0.0.
    • urllib: updated to version 2.2.2.
    • zipp: updated to version 3.19.1.
  • Added EULA-related statuses to processing jobs: LICENSED and UNLICENSED.
  • Marked CatalogBase.get_data_products as deprecated.

1.1.0

June 25, 2024
  • Supported new Webhook class functions:
    • Webhook.all
    • Webhook.get
    • Webhook.get_webhook_events
    • Webhook.save
  • Supported a new Processing module allowing the following:
    • Create templates for jobs
    • Validate jobs
    • Determine the cost of jobs
    • Run jobs
    • Monitor job statuses

1.0.4

June 17, 2024
  • Resolved an issue with pystac.Item.get_assets that caused accessing STAC assets to fail when using deepcopy support in the UP42 authentication layer.
  • Updated versions of Python packages:
    • requests: updated to version 2.32.0.
    • tornado: updated to version 6.4.1.
    • geopandas: updated to version 0.14.4.
    • tenacity: updated to version 8.4.1.
  • Marked webhook functions and attributes as deprecated:
    • webhook.info
    • webhook.update()
    • up42.initialize_webhook()
    • up42.get_webhook_events()
    • up42.create_webhook()
    • up42.get_webhooks()

1.0.3

May 23, 2024
  • Integrated tenacity as a dependency.
  • Implemented resilience mechanisms for asset.stac_info and asset.stac_items.
  • Removed PySTAC client subclassing.
  • Streamlined fixtures.
  • Expanded test coverage.
  • Removed unnecessary token exposure.

1.0.2

May 15, 2024

Implemented thread safety for token retrieval.

1.0.1

May 13, 2024
  • Enhanced HTTP resilience with increased retry attempts and backoff mechanisms.
  • Resolved an issue where temporary storage would exceed capacity during catalog downloads.
  • Updated the following dependencies: jinja2, tqdm, and geojson.

1.0.0

April 17, 2024
  • Removed project credentials as an authentication method.
  • Removed previously deprecated visualization functions:
    • folium_base_map()
    • draw_aoi()
    • map_quicklooks()
    • map_results()
    • plot_coverage()
    • plot_results()
    • plot_quicklooks()
    • plot_coverage()

0.37.2

April 8, 2024

Updated versions of Python packages:

  • black: updated to version 24.3.0.
  • pillow: updated to version 10.3.0.

0.37.1

April 5, 2024
  • Removed the upper-bound limitation for Python versions.
  • Discontinued support for Python 3.8.

0.37.0

March 15, 2024
  • Fixed unintentional removal of titles and tags during asset metadata updates.
  • Removed the unnecessary auth.env property and corresponding tests.
  • Expanded the new authentication stack to accommodate account authentication scenarios.
  • Added new components within the HTTP layer to facilitate future enhancements in authentication and request handling.
  • Aligned the majority of the code with Pylint checks.

0.36.0

February 20, 2024

Updated the place_order() and estimate_order() functions of the CatalogBase class to the latest version of the API.

0.35.0

January 25, 2024

  • Removed the following edit and create functions:

    • up42

      • validate_manifest()

    • Project

      • max_concurrent_jobs
      • update_project_settings()
      • create_workflow()

    • Workflow

      • max_concurrent_jobs
      • update_name()
      • add_workflow_tasks()
      • get_compatible_blocks()
      • get_parameters_info()
      • construct_parameters()
      • construct_parameters_parallel()
      • estimate_job()
      • test_job()
      • test_jobs_parallel()
      • run_job()
      • run_jobs_parallel()

    • Job

      • track_status()
      • cancel_job()

  • Marked the following visualization functions as deprecated:

    • up42

      • viztools.folium_base_map()

    • Catalog

      • plot_coverage()
      • map_quicklooks()
      • plot_quicklooks()

    • Job

      • map_results()
      • plot_results()

    • JobCollection

      • map_results()
      • plot_results()

    • JobTask

      • map_results()
      • plot_results()
      • plot_quicklooks()

0.34.1

December 15, 2023

Restored the order.get_assets() function.

0.34.0

December 13, 2023
  • Updated the storage.get_orders() function to the latest version of the API.
  • Set Poetry as the only dependency manager.
  • Removed the order.get_assets() function.

0.33.1

November 23, 2023

Marked the following parameters of storage.get_assets() as deprecated to enforce the use of the PySTAC client search.

  • geometry
  • acquired_before
  • acquired_after
  • custom_filter

0.33.0

November 14, 2023
  • Updated authentication by changing it from project-based to account-based.
  • Added a new function to the Asset class: get_stac_asset_url() generates a signed URL that allows to download a STAC asset from storage without authentication.

Last updated: