Changelog

This changelog outlines the latest updates to the UP42 API. Use it as a guide to understand the changes and how they might affect your integration.

Added↓

Supported a new STAC endpoint:

• PATCH /v2/assets/stac/collections/{collection-id}/items/{item-id}
  Use it to change the title and tags of a STAC item.

Deprecated↓ Added↓

Marked the following endpoints as deprecated:

• GET /v2/tasking/feasibility
• PATCH /v2/tasking/feasibility/{feasibility-id}

Added new endpoints with the same functionality to replace the deprecated ones:

• GET /v2/tasking/feasibility-studies
• PATCH /v2/tasking/feasibility-studies/{feasibility-study-id}

Added↓

Supported a new credits endpoint:

• GET /v2/payments/balances
  Use it to check the amount of UP42 credits on your account balance.

Updated↓

Made changes to the following endpoints:

• GET /v2/assets/stac/collections
  Discontinued support for the token parameter. Use the page parameter instead.

• GET /v2/assets/stac/collections/{collection-id}/items
  Discontinued support for the token parameter. Use the page parameter instead.

Removed↓

Decommissioned the rest of v1 processing endpoints:

• Projects

  • GET /projects/{project_id}/settings

• Workflows

  • GET /projects/{project_id}/workflows
  • GET /projects/{project_id}/workflows/{workflow_id}
  • GET /projects/{project_id}/workflows/{workflow_id}/tasks
  • GET /projects/{project_id}/workflows/{workflow_id}/compatible-blocks

• Blocks

  • GET /marketplace/blocks
  • GET /marketplace/blocks/{block_id}
  • GET /blocks
  • GET /blocks/{block_id}
  • GET /blocks/{block_id}/coverage:

• Jobs

  • GET /projects/{project_id}/jobs
  • GET /projects/{project_id}/jobs/{job_id}
  • GET /projects/{project_id}/jobs/{job_id}/tasks
  • GET /projects/{project_id}/jobs/{job_id}/estimate

• Job outputs

  • GET /projects/{project_id}/jobs/{job_id}/outputs/data-json
  • GET /projects/{project_id}/jobs/{job_id}/downloads/results
  • GET /projects/{project_id}/jobs/{job_id}/tasks/{task_id}/outputs/data-json
  • GET /projects/{project_id}/jobs/{job_id}/tasks/{task_id}/downloads/results
  • GET /projects/{project_id}/jobs/{job_id}/tasks/{task_id}/logs
  • GET /projects/{project_id}/jobs/{job_id}/tasks/{task_id}/outputs/quicklooks
  • GET /projects/{project_id}/jobs/{job_id}/tasks/{task_id}/outputs/quicklooks/{image_name}

• Credits

  • GET /projects/{project_id}/workflows/{workflow_id}/credits
  • GET /projects/{project_id}/jobs/{job_id}/credits

Updated↓

Updated the glossary endpoints’ integrations value from FEASIBILITY_MAY_BE_REQUIRED to FEASIBILITY_STUDY_MAY_BE_REQUIRED.

Added↓

Supported a new geometry endpoint:

• DELETE /v2/spatial/geometries/{geometry-id}
  Use it to delete a geometry from the library.

Added↓ Deprecated↓

Supported a new authentication endpoint:

• POST https://auth.up42.com/realms/public/protocol/openid-connect/token
  Use it to generate an API access token. Note the different server URL for this endpoint.

Marked the POST /oauth/token endpoint as deprecated.

Added↓ Deprecated↓

Supported new processing endpoints:

• GET /v2/processing/processes
  Use it to get a list of all processing capabilities.
• GET /v2/processing/processes/{process-id}
  Use it to get information about a specific processing capability.

Marked the rest of the v1 glossary endpoints as deprecated:

• GET /producers
• GET /producers/{producer_name}
• GET /hosts
• GET /hosts/{host_name}

Added↓

Supported new glossary endpoints:

• GET /v2/collections
  Use it to get a list of collections.
• GET /v2/collections/{collection-name}
  Use it to get information about a specific collection.
• GET /v2/data-products
  Use it to get a list of data products.
• GET /v2/data-products/{data-product-name}
  Use it to get information about a specific data product.

Deprecated↓

Marked some of the v1 glossary endpoints as deprecated:

• GET /collections
• GET /collections/{collection_name}
• GET /data-products
• GET /data-products/{data_product_id}

Deprecated↓

Marked the GET /accounts/me/credits/balance endpoint as deprecated.

Added↓

Supported new EULA endpoints:

• GET /v2/eulas
  Use it to get a list of EULAs.
• GET /v2/eulas/{eula-id}
  Use it to get information about a specific EULA.
• GET /v2/eulas/{eula-id}/documents
  Use it to get a list of digital documents associated with a EULA.
• GET /v2/eulas/{eula-id}/documents/{eula-document-id}
  Use it to get information about a specific digital document associated with a EULA.
• PATCH /v2/eulas/{eula-id}/documents/{eula-document-id}
  Use it to accept a specific digital document associated with a EULA.

Updated↓

Updated the GET /v2/processing/jobs endpoint to replace the size query parameter with the limit query parameter.

Updated↓

Updated the GET /v2/processing/jobs endpoint to mark the size query parameter as deprecated.

Removed↓

Decommissioned some of the v1 order endpoints:

• Orders

  • GET /workspaces/{workspace_id}/orders
  • POST /workspaces/{workspace_id}/orders
  • GET /workspaces/{workspace_id}/orders/{order_id}
  • GET /workspaces/{workspace_id}/orders/{order_id}/metadata

• Catalog

  • POST /workspaces/{workspace_id}/orders/estimate

Updated↓

Updated glossary objects:

• Beijing-3N:

  • Collection name is changed to beijing-3n-tasking.
  • The data product ID is changed to 306153d7-7c44-4621-9200-379c7f6cd649.

• Landsat 8:

  • The data product title is changed to Level 2SP.

• Sentinel-2:

  • The data product title is changed to Level 2A.

Updated↓

Updated the POST /v2/spatial/geometries endpoint to return a 201 response upon successful request completion instead of a 200 response.

Removed↓

Removed the trailing slash at the end of the GET /v2/assets/stac endpoint.

Updated↓

Made changes to the following endpoints:

• GET /v2/assets/stac/collections

  • Enabled support for page-based pagination.
  • Added a context object to the endpoint’s response.

• GET /v2/assets/stac/collections/{collection-id}/items

  • Enabled support for page-based pagination.

Added↓

Supported a new order endpoint:

• PATCH /v2/orders/{order-id}
  Use it to change details of an existing tasking or catalog order.

Removed↓

Decommissioned some of the v1 analytics endpoints:

• Projects

  • PUT /projects/{project_id}/settings

• Workflows

  • POST /projects/{project_id}/workflows
  • DELETE /projects/{project_id}/workflows/{workflow_id}
  • POST /projects/{project_id}/workflows/{workflow_id}/tasks

• Jobs

  • POST /projects/{project_id}/estimate/job
  • POST /estimate/job
  • POST /projects/{project_id}/jobs/validate
  • POST /projects/{project_id}/workflows/{workflow_id}/jobs/{job_id}
  • PUT /projects/{project_id}/workflows/{workflow_id}/jobs/{job_id}
  • POST /projects/{project_id}/workflows/{workflow_id}/jobs
  • POST /projects/{project_id}/jobs/{job_id}/cancel

• Blocks

  • POST /validate-schema/block

Added↓

Supported a new processing endpoint:

• POST /v2/processing/processes/{process-id}/cost
  Use it to determine the cost before creating a processing job.

Added↓

Supported new order, tasking, and geometry endpoints:

• Orders

  • POST /v2/orders
    Use it to create a new tasking or catalog order.
  • POST /v2/orders/estimate
    Use it to get a cost estimation before creating a tasking or a catalog order.

• Tasking

  • GET /v2/coverage/orders/{order-id}
    Use it to get coverage information for a tasking order.

• Geometries

  • GET /v2/spatial/geometries
    Use it to get a list of geometries saved in the library.
  • POST /v2/spatial/geometries
    Use it to add a new geometry to the library.
  • GET /v2/spatial/geometries/{geometry-id}
    Use it to get information about a specific geometry saved in the library.
  • PATCH /v2/spatial/geometries/{geometry-id}
    Use it to update an existing geometry saved in the library.

Removed↓

Decommissioned product configuration endpoints and v1 asset endpoints:

• Product configurations

  • GET /product-configurations
  • GET /product-configurations/{product_configuration_id}

• Assets

  • GET /workspaces/{workspace_id}/assets
  • GET /workspaces/{workspace_id}/assets/{asset_id}
  • GET /workspaces/{workspace_id}/assets/{asset_id}/downloadUrl

Deprecated↓

Marked the v1 order creation endpoint and catalog estimation endpoint as deprecated:

• POST /workspaces/{workspace_id}/orders/estimate
• POST /workspaces/{workspace_id}/orders