Changelog
Canopy API Changelog
2024-07-17
Added
- Added new
Task.tags
field 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:
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. IfTrue
, 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
andFeasibility
models in the API Reference
Fixed
- DeliveryConfig path interpolation for
S3_UMBRA_ROLE
configs will now replaceTask.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
andstep
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
andOpportunity.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 forS3UmbraRole
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-20Collect.rangeResolutionMinMeters
now reports the correct value for Collects created after 2023-06-20
2023-06-13
Added
- Added Changelog to Canopy API Documentation
Updated 3 months ago