Changelog

2024-12-20

Changed

• The Canopy Archive Catalog API at https://api.canopy.umbra.space/archive now use the standard Rate Limiting rules

Security

• The Canopy Archive Catalog API at https://api.canopy.umbra.space/archive now requires Authentication

2024-07-17

Added

• Added new Task.tagsfield for Create Task
• Added new endpoint to return product constraints per imaging mode: Get Products
• Added Natural Footprint scene size for Create Task and Create Feasibility
• Added new product types for tasking: CSI SIDD, CSI TIFF, and DI GIF
• Added new Task.userEmail field for Get Task
• Added default product types per org: Get Organization Settings

Changed

• Deprecated STAC API in favor of STAC API v2. See also: Migrate to STAC API v2
• Set default scene size to 5x5 km: Create Task
• Deliver only products requested by customer at tasking time

Fixed

• Fixes to allow S3 copy to succeed for very large files
• Require at least one non-metadata product for delivery

2024-01-23

Fixed

• Improved error messages for certain invalid search queries for the Archive Catalog
• Fixed bug with blank image detection over oceans on collect redelivery

2023-12-05

Added

• 🎉 New Feature: Extended Scene Size
  • Create Spotlight Tasks with Scene Sizes up to 10 x 10km!

Fixed

• Sandbox Collects now have a duration of ~10s, occurring at the beginning of the parent Task window.
  • This replaces the old behavior where Sandbox Collect length was always the entire length of the parent Task window
  • This allows for more realistic tasking workflows and allows Collects to begin transitioning past SCHEDULED up to days earlier than before

2023-11-07

Added

• 🎉 New Feature: Umbra Archive Catalog
  • Browse all orderable Archive imagery from Umbra via a v1.0.0 compliant STAC API: API Reference
  • All Umbra archive data is available in the umbra-sar STAC Collection
  • Guides:
    • Archive Catalog: Searching via STAC API
    • Archive Catalog: Developer Tooling

2023-10-24

Changed

• Changed spotlightConstraints.grazingAngleMaxDegrees from 75 to 90 for Create Feasibility and Create Task

2023-10-18

Added

• Added support to POST /search/tasks endpoint for filtering by intersecting geometry

2023-09-19

Added

• Added sicdXmlMetadata: bool = False option to Post Delivery Config. If True, the SICD XML Metadata will be rendered and delivered alongside the Umbra Collect Metadata json file with suffix ending _SICD-METADATA.xml

Changed

• Create Task rate limits increased to 2/second, 120/min, 120/hour

Fixed

• Fixed an issue that led to some file transfers failing when sent to S3 buckets in GovCloud
• Fixed an issue that could lead to 500 errors when querying Get Organization Settings
• Fixed an issue where Get Collect geometries, collect times, and collect properties would not update correctly if a Collect is moved on the spacecraft Schedule

2023-09-05

Fixed

• The Umbra Open Data STAC Catalog is now a valid STAC 1.0.0 catalog

2023-08-29

Added

• Added Organization.slaLatencySeconds to Get Organization Settings

2023-08-22

Added

• Added Get Organization Settings which can be used to programmatically retrieve the settings applied to a user's Canopy Organization

Fixed

• Fixed an issue where status_history field was not available within the Developer Sandbox

2023-08-15

Changed

• In accordance with the updated Terms of Umbra's NOAA License, Umbra no longer performs resolution checks for any customer Collects before delivering them. In practice, this means that all requested product types for a given Collect will be delivered regardless of requested range resolution.

Fixed

• Fixed an issue where re-delivery of images from our Archive would send the incorrect metadata file
• Fixed the incorrectly stated rate limits for Create Feasibility in the Rate Limiting documentation

2023-08-08

Changed

• Increased rate limits on Create Task, Create Feasibility, and Cancel Task. Please review the updated rate limits table for these endpoints at Rate Limiting.
• When retrieving access tokens via the Client Credentials workflow, https://auth.canopy.umbra.space/oauth/token will now return HTTP status code 400 instead of 500 when rate limiting is in effect. Please review the documentation here for more details.
• Improved documentation for all enumerations associated with the Task and Feasibility models in the API Reference

Fixed

• DeliveryConfig path interpolation for S3_UMBRA_ROLE configs will now replace Task.userOrderId = None with an empty string in the path rather than the string "None"

2023-07-21

Fixed

• Terrain elevation value calculated during Task creation now uses WGS84 model instead of EGM96 Create Task

2023-07-11

Added

• Opportunities that are before the next comm with the associated satellite are now filtered out of Feasibility results
• Create Task and Create Feasibility now reject requests with status code 422 when the request is within a Restricted Access Area

Fixed

• Fixed 500 errors when requesting out of bounds limit and step parameters on Post Search Tasks and Post Search Collects. These endpoints now correctly return 422 when out of bounds values are supplied.
• Fixed rare 500 errors when requesting specific Tasks via Post Search Tasks and Get Task

2023-06-27

Added

• Added Task.satelliteIds to enable satellite selection when creating a new Task

Changed

• Increased SpotlightConstraints.grazingAngleMinDegrees maximum value from 69 to 74
• Padded Opportunity.windowStartAt and Opportunity.windowEndAt results by five minutes each to avoid unnecessarily rejected Tasks due to small adjustments by the Umbra Scheduler

Fixed

• Fixed error code returned after successfully deleting M2M token

2023-06-20

Added

• Added Collects API to allow search and direct retrieval of Collect information.
  • ⚠️ This release deprecates usage of the STAC Items in the STAC API for Collect status and history information.
• Added Restricted Access Areas API to allow retrieval of locations where Tasking is disallowed for your Canopy organization.
• Added Client Credentials API to allow customer self service of their organization's Machine to Machine token. Credentials can be created, retrieved, rotated, and deleted.
• Added DeliveryConfig.options.isLegacyPathPrefix field for S3UmbraRole configurations. All new DeliveryConfigs should leave this option False unless otherwise specifically instructed by Canopy customer support.

Fixed

• Improved validation for SpotlightConstraints.rangeResolutionMinMeters
• Improved validation for SpotlightConstraints.multilookFactor
• Collect.azimuthResolutionMinMeters now reports the correct value for Collects created after 2023-06-20
• Collect.rangeResolutionMinMeters now reports the correct value for Collects created after 2023-06-20

2023-06-13

Added

• Added Changelog to Canopy API Documentation