Quotas & Limits

Limits and quotas are tied to your user account and apply to all requests you make, including requests made to the Descartes Labs Platform from your Tasks.

Various limits and quotas apply to each service and operation. The most common types of limits are Rate Limits and Usage Quotas.

Rate limits are used to prevent overloading the Descartes Labs Platform with too many concurrent requests. Rate limits are specified as number of requests/unit of time.

Query time limits are used to prevent overloading the Descartes Labs Platform with too many computationally intensive requests. The amount of computation resources required to return the results of a search request vary greatly based on the search parameters. If too many complex queries are sent to our platform within a designated time frame by a single user, the service will return a RateLimitExceeded error. Image search and summary queries from the Catalog service are limited by total query time with one minute and five minute windows.

Usage quotas keep track of how much you use the Descartes Labs Platform and prevent you from accessing the platform after your quota has been reached. Each service measures usage differently, see below for details on how usage is measured and limited. Usage quotas are typically reset monthly. Contact support@descarteslabs.com for help with usage quotas.

Catalog

These limits apply to the Catalog client.

Rate limits

Band operations

  • Create a new band - 500/minute
  • Change a band - 500/minute
  • Delete a band - 500/minute
  • Get a band - 10,000/minute
  • Search bands - 20,000/minute

Image operations

  • Create a new image - 10,000/minute
  • Change an image - 10,000/minute
  • Delete an image - 500/minute
  • Get an image - 10,000/minute
  • Search images - 5,000/minute (note: these requests are also limited by query time)
  • Get image summary statistics - 60/minute (note: these requests are also limited by query time)
  • Upload an image file or ndarray - 10,000/minute
  • Get image upload task status - 500/minute

Product operations

  • Create a new product - 500/minute
  • Change a product - 500/minute
  • Delete a product - 500/minute
  • Get a product - 10,000/minute
  • Search products - 5,000/minute
  • Delete all related objects - 60/minute
  • Update permissions for all related objects - 60/minute
  • Retrieve the status for the above operations - 500/minute

Scenes

These limits apply to the Scenes client.

Rate limits

Band operations

  • Get a band by id - 10,000/minute
  • Get all bands for a product - 5,000/minute
  • Get band fields - 500/minute
  • Get multiple bands by id - 5,000/minute
  • Search bands - 5,000/minute

Derived Band operations

  • Get derived band fields - 500/minute
  • Search derived bands - 5,000/minute

Image operations

  • Get an image by id - 10,000/minute
  • Get multiple images by id - 50,000/minute
  • Get image fields - 1,000/minute
  • Search images - 5,000/minute

Product operations

  • List products - 500/minute
  • Search products - 5,000/minute

Raster

These limits apply both to the Raster and Scenes clients.

General limitations

When retrieving a GeoTiff or ndarray

  • Maximum number of scenes to rasterize - 500
  • Maximum image size - 5 GiB

Rate Limits

  • Rasterize a GeoTiff or ndarray - 8,000/minute
  • Get DLTile keys from shape - 10,000/minute
  • Get DLTile from a key - 10,000/minute
  • Get DLTile from LatLon - 10,000/minute

Storage

These limits apply to the Storage client.

General limitations

You can gain access to some proprietary products through storage by speaking with support@descarteslabs.com.

Rate limits

  • List objects - 10,000/minute
  • Delete an object - 50,000/minute
  • Upload an object - 50,000/minute

Tasks

These limits apply to the Tasks client.

General limitations

  • Maximum number of concurrent workers per Task group - 500
  • Maximum size of memory per worker - 96 GiB
  • Maximum number of CPU cores per worker -16
  • Maximum number of GPUs per worker - 1
  • Maximum runtime per task - 24 hours
  • Maximum size of bundled code - 10 MiB
This limitation only applies to the code you include with include_modules and does not apply to packages included with requires.

Vectors

These limits apply both to the Vectors and Vector clients.

Rate limits

Feature collection operations

  • List feature collections - 1,000/minute
  • Get a feature collection - 1,000/minute
  • Create a new feature collection - 10/minute
  • Delete a feature collection - 10/minute
  • Get the status of a delete feature collection task - 1,000/minute
  • Copy a feature collection - 10/minute
  • Get the status of a copy feature collection task - 1,000/minute
  • Export a feature collection - 10/minute
  • Get the status of an export feature collection task - 1,000/minute
  • Search features in a feature collection - 50/minute
Results from a search operation are paged, and retrieving page results are rate limited at 5,000 requests per minute. This means it’s possible to be rate-limited as you are iterating through the result of a filter operation.
  • Create new features - 2,000/minute
  • Upload new features - 1,000/minute
  • List the status of a upload feature collection tasks - 1,000/minute

Workflows

These limits apply to the Workflows.

General limitations

  • Maximum number of Workflows saved - 1000

Usage Quotas

If you do not have a specific quota for you or your organization, then you are limited to querying 2 TiB of data per month.