Cognite Data Fusion API

Create 3D revisions

Creates revision(s) and starts processing job(s).

Check beta API documentation for information about additional options.

Hybrid projects: Use the CreateRevision3DClassicAndHybridBody to create revisions.

DataModelOnly: Please use the 3d/jobs endpoint (Beta for now) to create the revision(s) and start jobs. CreateRevision3DDmsOnlyBody will eventually be deprecated.

Securityoidc-token or oauth2-client-credentials or oauth2-open-industrial-data or oauth2-auth-code

Request

path Parameters

modelId

required

integer <int64>

Model ID.

Request Body schema: application/json

The revisions to create.

One of:

required

Array of objects (CreateRevision3D) [ 1 .. 1000 ] items

Responses

201

A list of created revisions.

400

The response for a failed request.

post/3d/models/{modelId}/revisions

Request samples

Payload
JavaScript SDK
Python SDK
Java SDK
curl

application/json

{"items": [{"published": false,
"rotation": [0,
0,
0
],
"scale": [1,
1,
1
],
"translation": [0,
0,
0
],
"metadata": {"property1": "string",
"property2": "string"
},
"camera": {"target": [0,
0,
0
],
"position": [0,
0,
0
]
},
"fileId": 0,
"nonce": "string",
"pipelineConfiguration": {"indexingOptions": {"extractPhotosphereImages": false,
"dmsInstancesSpaceId": "string"
},
"processTilesOptions": {"saveAnnotations": true
}
}
}
]
}

Response samples

application/json

{"items": [{"id": 1000,
"fileId": 1000,
"published": false,
"rotation": [0,
0,
0
],
"scale": [1,
1,
1
],
"translation": [0,
0,
0
],
"camera": {"target": [0,
0,
0
],
"position": [0,
0,
0
]
},
"status": "Done",
"metadata": {"property1": "string",
"property2": "string"
},
"thumbnailThreedFileId": 1000,
"thumbnailURL": "https://api.cognitedata.com/api/v1/project/myproject/3d/files/1000",
"assetMappingCount": 0,
"createdTime": 0
}
]
}

➔ Next to Delete 3D revisions