Interact with your data analysis jobs.

Create, update, delete jobs.

realitydataanalysis

Included job execution errors and warnings (if any) in 'Get job' operation response.

Added support of one SRSId per annotation (ContextScene V4).

Added support of OPC files for Segmentation3D.

Added Polygons2D annotation type.

Added job types : Objects3D, Segmentation3D, Lines3D, ChangeDetection.

Added Segmentation2D output arguments : lines2D, polygons2D, exportedPolygons2DSHP.

Initial technology preview version of the service
Added job types "Objects 2D" and "Segmentation2D" (technology preview)

Added compatibility with photo segmentation detectors using ONNX models

---

Create a new job based on its type and settings

### Authentication

Requires `Authorization` header with valid Bearer token for scope `realitydataanalysis:modify`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---


jobs-create

OAuth access token with scope `realitydataanalysis:modify`

Authorization

Setting to `application/vnd.bentley.itwin-platform.v1+json` is recommended.

Accept

My first objects2D job

This response indicates that request lacks valid authentication credentials. Access token might not been provided, issued by the wrong issuer, does not have required scopes or request headers were malformed.

application/json;InvalidAuthorizationScheme

The 422 (Unprocessable Entity) status code indicates that the request cannot be processed by the server due to a client error (e.g. malformed request syntax).

This response indicates that the user has sent too many requests in a given amount of time.

The number of requests exceeds the rate-limit for the client subscription.

retry-after

---

Delete an unsubmitted job

### Authentication

Requires `Authorization` header with valid Bearer token for scope `realitydataanalysis:modify`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---


jobs-delete

jobId

Job can't be deleted once it has been submitted.

---

Retrieve job details, such as current state, execution information, outputs, etc.

### Parameters

The job id

### Authentication

Requires `Authorization` header with valid Bearer token for scope `realitydataanalysis:read`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---


jobs-get

OAuth access token with scope `realitydataanalysis:read`

---

Retrieve job progress.

### Parameters

The job id

### Remarks

The job progression is deemed valid when the job is active and won't be available after 30 days.

Client should query with a backoff intervals [15,30,60,120] seconds. The interval between the first and second query is 15 sec and then 30 sec... If the percentage changes the sequence is restarted.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `realitydataanalysis:read`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---


jobs-progress

---

Patch an existing job

Patch can be used for changing the job state (to active or cancelled), updating job type and settings or changing cost estimation parameters.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `realitydataanalysis:modify`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---


jobs-patch

Changelog - Reality Analysis | iTwin Platform

This tutorial is an introduction to Reality Analysis API, explaining the basic workflows.

Changelog

Aug 28, 2023

Oct 26, 2022

Oct 26, 2022