.. Copyright (C) 2025 SpaceKnow, Inc. .. _api.api-errors: ********** API errors ********** Specific error codes along with their status codes and meaning are described in this part of the documentation. See also `OpenAPI docs`_. .. _OpenAPI docs: https://docs.spaceknow.com/redoc.html General API Error Codes ----------------------- * 400 * ``BAD-CONTENT-TYPE`` -- Passed content type is not allowed for this endpoint. * ``EXTENT-HAS-NO-INTERSECTION`` -- Requested extent has no intersection with involved scenes. * ``BAD-REQUEST`` -- Request cannot be fulfilled. * ``EXTENT-TOO-SMALL`` -- Scene GSD is too coarse for the requested algorithm. * ``BAD-PROTOCOL`` -- Only https protocol is supported. \ * 401 (see also :ref:`authorization ` and :ref:`permissions`.) * ``INVALID-AUTHORIZATION-HEADER`` -- Request authorization header is malformed or missing. * ``NOT-AUTHORIZED`` -- User is not authorized to access this resource. \ .. only:: not holygrail * 402 * ``CREDITS-ERROR`` -- Requested scene or tile is not allocated. \ * 403 * ``AUTHORIZATION-WITHOUT-CONTEXT-NOT-PERMITTED`` -- API key authorization requires user ID and accounting for this endpoint. * ``API-KEY-AUTHORIZATION-NOT-PERMITTED`` -- API key authorization is not permitted for this endpoint. * ``USER-AUTHORIZATION-NOT-PERMITTED`` -- User authorization is not permitted for this endpoint. \ * 404 * ``NO-VALID-BINDING`` -- User is not bound to any credit group. * ``NON-EXISTENT-ENDPOINT`` -- Requested endpoint does not exist. \ * 405 * ``METHOD-NOT-ALLOWED`` -- Used HTTP method is not allowed for this endpoint. \ * 413 * ``PAYLOAD-TOO-LARGE`` -- Request body payload is too large. \ * 422 * ``VALIDATION-ERROR`` -- Request body (or query) did not pass validation. \ * 424 * ``PROCESSING-ERROR`` -- Something went wrong in pipeline processing. \ * 500 * ``ERROR`` -- Unexpected error occurred, please try again later. \ Tasking API Error Codes ------------------------------- * 404 * ``NON-EXISTENT-PIPELINE`` -- Requested pipeline does not exist. \ Ragnar API Error Codes ------------------------------- * 400 * ``DATASET-NOT-SUPPORTED-FOR-SEARCH`` -- Dataset is deprecated and does not support searching for imagery. \ * 404 * ``NON-EXISTING-SCENE`` -- Requested scene does not exist. * ``NON-EXISTENT-PIPELINE`` -- Requested pipeline does not exist. \ Kraken API Error Codes ------------------------------- * 400 * ``NON-EXISTENT-GEOMETRY`` -- Geometry does not exist. * ``INVALID-QUERY-PARAMETER`` -- Kraken tile grid query parameter is invalid. * ``TOO-BIG-TILE-AREA`` -- Requested area is too big for one analysis. * ``UNSUPPORTED-IMAGERY`` -- Operation is not supported on requested imagery. * ``DATASET-NOT-SUPPORTED-FOR-SEARCH`` -- Dataset is deprecated and does not support searching for imagery. * ``GSD-TOO-COARSE`` -- Scene GSD is too coarse for the requested algorithm. * ``INVALID-GEOJSON`` -- GeoJSON is outside Web Mercator latitude bounds. * ``INVALID-MAP-ID`` -- Encoded map ID is invalid. \ * 401 (see also :ref:`authorization ` and :ref:`permissions`.) * ``NOT-PERMITTED-COORDINATES`` -- Requested coordinates are not permitted for given map ID. * ``ACCESS-DENIED`` -- You do not have permissions to access other users' resources. \ * 404 * ``UNSUPPORTED-FILE-NAME`` -- Requested kraken grid file is not supported for this map type. * ``NON-EXISTENT-PIPELINE`` -- Requested pipeline does not exist. * ``TILE-DOES-NOT-EXIST`` -- Requested kraken grid tile does not exist. * ``NON-EXISTING-SCENE`` -- Requested scene does not exist. \ * 424 * ``PERCENTILE-STRETCH-UNAVAILABLE`` -- Percentile stretch visualization is unavailable for this scene. \ Geojsondb API Error Codes ------------------------------- * 400 * ``NON-EXISTENT-GEOMETRY`` -- Geometry does not exist. * ``INVALID-QUERY-PARAMETER`` -- Kraken tile grid query parameter is invalid. * ``TOO-BIG-TILE-AREA`` -- Requested area is too big for one analysis. * ``UNSUPPORTED-IMAGERY`` -- Operation is not supported on requested imagery. * ``DATASET-NOT-SUPPORTED-FOR-SEARCH`` -- Dataset is deprecated and does not support searching for imagery. * ``GSD-TOO-COARSE`` -- Scene GSD is too coarse for the requested algorithm. * ``INVALID-GEOJSON`` -- GeoJSON is outside Web Mercator latitude bounds. * ``INVALID-MAP-ID`` -- Encoded map ID is invalid. \ * 401 (see also :ref:`authorization ` and :ref:`permissions`.) * ``NOT-PERMITTED-COORDINATES`` -- Requested coordinates are not permitted for given map ID. * ``ACCESS-DENIED`` -- You do not have permissions to access other users' resources. \ * 404 * ``UNSUPPORTED-FILE-NAME`` -- Requested kraken grid file is not supported for this map type. * ``NON-EXISTENT-PIPELINE`` -- Requested pipeline does not exist. * ``TILE-DOES-NOT-EXIST`` -- Requested kraken grid tile does not exist. * ``NON-EXISTING-SCENE`` -- Requested scene does not exist. \ * 424 * ``PERCENTILE-STRETCH-UNAVAILABLE`` -- Percentile stretch visualization is unavailable for this scene. \ User API Error Codes ------------------------------- * 400 * ``UNSUPPORTED-IMAGERY`` -- Operation is not supported on requested imagery. * ``GSD-TOO-COARSE`` -- Scene GSD is too coarse for the requested algorithm. * ``TOO-BIG-TILE-AREA`` -- Requested area is too big for one analysis. * ``INVALID-QUERY-PARAMETER`` -- Kraken tile grid query parameter is invalid. * ``INVALID-GEOJSON`` -- GeoJSON is outside Web Mercator latitude bounds. * ``USER-BLOCKED`` -- User is blocked and unavailable for the requested operation. * ``NON-EXISTENT-GEOMETRY`` -- Geometry does not exist. * ``DATASET-NOT-SUPPORTED-FOR-SEARCH`` -- Dataset is deprecated and does not support searching for imagery. * ``INVALID-MAP-ID`` -- Encoded map ID is invalid. \ * 401 (see also :ref:`authorization ` and :ref:`permissions`.) * ``ACCESS-DENIED`` -- You do not have permissions to access other users' resources. * ``NOT-PERMITTED-COORDINATES`` -- Requested coordinates are not permitted for given map ID. \ * 404 * ``UNSUPPORTED-FILE-NAME`` -- Requested kraken grid file is not supported for this map type. * ``NON-EXISTENT-PIPELINE`` -- Requested pipeline does not exist. * ``TILE-DOES-NOT-EXIST`` -- Requested kraken grid tile does not exist. * ``NON-EXISTING-SCENE`` -- Requested scene does not exist. * ``NON-EXISTENT-USER`` -- Requested user does not exist. \ * 409 * ``CONFLICT`` -- Can't modify this resource because of a conflict in data. \ * 424 * ``PERCENTILE-STRETCH-UNAVAILABLE`` -- Percentile stretch visualization is unavailable for this scene. \ * 429 * ``TOO-MANY-REQUESTS`` -- Too many requests, please try again later. \ .. only:: not holygrail Credits API Error Codes ------------------------------- * 400 * ``UNSUPPORTED-IMAGERY`` -- Operation is not supported on requested imagery. * ``GSD-TOO-COARSE`` -- Scene GSD is too coarse for the requested algorithm. * ``TOO-BIG-TILE-AREA`` -- Requested area is too big for one analysis. * ``INVALID-QUERY-PARAMETER`` -- Kraken tile grid query parameter is invalid. * ``INVALID-GEOJSON`` -- GeoJSON is outside Web Mercator latitude bounds. * ``USER-BLOCKED`` -- User is blocked and unavailable for the requested operation. * ``NON-EXISTENT-GEOMETRY`` -- Geometry does not exist. * ``DATASET-NOT-SUPPORTED-FOR-SEARCH`` -- Dataset is deprecated and does not support searching for imagery. * ``INVALID-MAP-ID`` -- Encoded map ID is invalid. \ * 401 (see also :ref:`authorization ` and :ref:`permissions`.) * ``EXPIRED-LICENSE`` -- Group license is expired. * ``NOT-ENOUGH-CREDITS`` -- User group does not have enough credits for requested action. * ``ACCESS-DENIED`` -- You do not have permissions to access other users' resources. * ``NOT-PERMITTED-COORDINATES`` -- Requested coordinates are not permitted for given map ID. \ * 404 * ``UNSUPPORTED-FILE-NAME`` -- Requested kraken grid file is not supported for this map type. * ``NON-EXISTENT-PIPELINE`` -- Requested pipeline does not exist. * ``TILE-DOES-NOT-EXIST`` -- Requested kraken grid tile does not exist. * ``NON-EXISTING-SCENE`` -- Requested scene does not exist. * ``NON-EXISTENT-COST-TIER`` -- Requested cost tier does not exist. * ``NON-EXISTENT-USER`` -- Requested user does not exist. \ * 409 * ``CONFLICT`` -- Can't modify this resource because of a conflict in data. \ * 424 * ``PERCENTILE-STRETCH-UNAVAILABLE`` -- Percentile stretch visualization is unavailable for this scene. * ``EXTENT-TOO-LARGE`` -- Image pixel area is larger than maximum allowed area. \ * 429 * ``TOO-MANY-REQUESTS`` -- Too many requests, please try again later. \ .. only:: not holygrail Datacube API Error Codes ------------------------------- * 400 * ``UNSUPPORTED-IMAGERY`` -- Operation is not supported on requested imagery. * ``GSD-TOO-COARSE`` -- Scene GSD is too coarse for the requested algorithm. * ``TOO-BIG-TILE-AREA`` -- Requested area is too big for one analysis. * ``INVALID-QUERY-PARAMETER`` -- Kraken tile grid query parameter is invalid. * ``INVALID-GEOJSON`` -- GeoJSON is outside Web Mercator latitude bounds. * ``USER-BLOCKED`` -- User is blocked and unavailable for the requested operation. * ``NON-EXISTENT-GEOMETRY`` -- Geometry does not exist. * ``DATASET-NOT-SUPPORTED-FOR-SEARCH`` -- Dataset is deprecated and does not support searching for imagery. * ``INVALID-MAP-ID`` -- Encoded map ID is invalid. \ * 401 (see also :ref:`authorization ` and :ref:`permissions`.) * ``EXPIRED-LICENSE`` -- Group license is expired. * ``NOT-ENOUGH-CREDITS`` -- User group does not have enough credits for requested action. * ``ACCESS-DENIED`` -- You do not have permissions to access other users' resources. * ``NO-MATCHING-PACKAGE`` -- You are not allowed to use requested resource. * ``NOT-PERMITTED-COORDINATES`` -- Requested coordinates are not permitted for given map ID. \ * 404 * ``PRODUCT-HAS-NO-DATA`` -- No data found for requested product. * ``UNSUPPORTED-FILE-NAME`` -- Requested kraken grid file is not supported for this map type. * ``NON-EXISTENT-PIPELINE`` -- Requested pipeline does not exist. * ``TILE-DOES-NOT-EXIST`` -- Requested kraken grid tile does not exist. * ``NON-EXISTENT-PRODUCT`` -- Requested product does not exist. * ``NON-EXISTING-SCENE`` -- Requested scene does not exist. * ``NON-EXISTENT-COST-TIER`` -- Requested cost tier does not exist. * ``NON-EXISTENT-USER`` -- Requested user does not exist. \ * 409 * ``CONFLICT`` -- Can't modify this resource because of a conflict in data. \ * 424 * ``UNSUPPORTED-POSTPROCESS`` -- Used datacube postprocess is not supported. * ``PERCENTILE-STRETCH-UNAVAILABLE`` -- Percentile stretch visualization is unavailable for this scene. * ``EXTENT-TOO-LARGE`` -- Image pixel area is larger than maximum allowed area. \ * 429 * ``TOO-MANY-REQUESTS`` -- Too many requests, please try again later. \