Create a job using 3D source data

curl --request POST \
  --url https://{cluster}.cognitedata.com/api/v1/projects/{project}/3d/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "space": "<string>",
      "externalId": "<string>",
      "name": "<string>",
      "source": {
        "instanceId": {
          "space": "<string>",
          "externalId": "<string>"
        }
      },
      "configuration": {},
      "nonce": "<string>"
    }
  ]
}
'

{
  "items": [
    {
      "space": "<string>",
      "externalId": "<string>",
      "name": "<string>",
      "source": {
        "instanceId": {
          "space": "<string>",
          "externalId": "<string>"
        }
      },
      "configuration": {},
      "createdAt": 123
    }
  ]
}

Create a job using 3D source data

Required capabilities: datamodels:READ(cdf_cdm, cdf_cdm_3d) datamodelinstances:WRITE

Creates a job to be run using a 3D source. Currently supported in data-modeling projects only. The user defines a dms instance they want the job to run against, and defines it as the source of the job. Inside the job you define the space a job will exist in, and its external id, this is not populated into dms. The job external id should be created by the client, and be unique. If the job result is stored in dms, it will be stored using the space of the job. A session nonce is required by the request.

Job types with supported job sources:

Job Type: ImageTextDetection, Job Source type: Cognite360ImageCollection

POST

jobs

Create a job using 3D source data

curl --request POST \
  --url https://{cluster}.cognitedata.com/api/v1/projects/{project}/3d/jobs \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "items": [
    {
      "space": "<string>",
      "externalId": "<string>",
      "name": "<string>",
      "source": {
        "instanceId": {
          "space": "<string>",
          "externalId": "<string>"
        }
      },
      "configuration": {},
      "nonce": "<string>"
    }
  ]
}
'

{
  "items": [
    {
      "space": "<string>",
      "externalId": "<string>",
      "name": "<string>",
      "source": {
        "instanceId": {
          "space": "<string>",
          "externalId": "<string>"
        }
      },
      "configuration": {},
      "createdAt": 123
    }
  ]
}

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.

Body

application/json

The job with a given source. Currently supports only one job to be created at the time.

items

object[]

required

Required array length: 1 element

Show child attributes

Response

A list of the created jobs

items

object[]

required

Show child attributes

Last modified on June 2, 2026

3D Jobs

List jobs

⌘I

Documentation Index

Authorizations

Body

Response