Skip to main content
PUT
/
geospatial
/
featuretypes
/
{featureTypeExternalId}
/
features
/
{featureExternalId}
/
rasters
/
{rasterPropertyName}
Put a raster into a feature property
curl --request PUT \
  --url https://{cluster}.cognitedata.com/api/v1/projects/{project}/geospatial/featuretypes/{featureTypeExternalId}/features/{featureExternalId}/rasters/{rasterPropertyName} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/octet-stream' \
  --data '"<string>"'
{
  "srid": 3857,
  "width": 4,
  "height": 5,
  "numBands": 1,
  "scaleX": 1,
  "scaleY": 1,
  "skewX": 0,
  "skewY": 0,
  "upperLeftX": -0.5,
  "upperLeftY": -0.5
}

Documentation Index

Fetch the complete documentation index at: https://docs.cognite.com/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Access token issued by the CDF project's configured identity provider. Access token must be an OpenID Connect token, and the project must be configured to accept OpenID Connect tokens. Use a header key of 'Authorization' with a value of 'Bearer $accesstoken'. The token can be obtained through any flow supported by the identity provider.

Path Parameters

​
featureTypeExternalId
string
required

External Id of the feature type provided by client. Must be unique among all feature type external ids within a CDF project.

Maximum string length: 32
Pattern: ^[A-Za-z][A-Za-z0-9_]{0,31}$
Example:

"ocean_measures"

​
featureExternalId
string
required

External Id of the type provided by client. Must be unique among all feature external ids within a CDF project and feature type.

Maximum string length: 256
Pattern: ^[A-Za-z][A-Za-z0-9_]{0,255}$
Example:

"ocean_measure_W87H62"

​
rasterPropertyName
string
required

Raster Id of the raster property provided by client. Must be unique among all feature property names within a feature type.

Maximum string length: 32
Pattern: ^[A-Za-z][A-Za-z0-9_]{0,31}$
Example:

"bathymetry"

Query Parameters

​
srid
integer
required

mandatory parameter that specifies the SRID of the coordinate reference system of a raster.

Required range: 1 <= x <= 999999
Example:

3857

​
format
enum<string>
required

mandatory parameter that specifies the format of the input raster.

Available options:
XYZ
Example:

"XYZ"

​
scaleX
number<double>

optional parameter that specifies the pixel scale x in storage. If not specified, the pixel scale remains the same as the input raster.

Example:

2

​
scaleY
number<double>

optional parameter that specifies the pixel scale y in storage. If not specified, the pixel scale remains the same as the input raster.

Example:

2

​
allowCrsTransformation
boolean

Optional parameter indicating if the input raster coordinates should be transformed into the Coordinate Reference Systems defined for the raster property in the feature type specification. The transformation will typically impact the pixel values. When the parameter is false, requests with rasters in Coordinate Reference System different from the ones defined in the feature type will result in bad request response code.

Example:

true

Body

application/octet-stream

The body is of type file.

Response

The raster metadata.

​
srid
integer
​
width
integer
​
height
integer
​
numBands
integer
​
scaleX
number<double>
​
scaleY
number<double>
​
skewX
number<double>
​
skewY
number<double>
​
upperLeftX
number<double>
​
upperLeftY
number<double>
Last modified on June 2, 2026