Convert mentioned point cloud formats to web-friendly Orbit Point Cloud.

realityconversion

Added support of Cesium Point Cloud 1.0 output format.

Added support of multiple input containers for a job

Added support of conversion and merge of all input files into one single output.

Added technology preview operation 'Create a job'.

Added technology preview operation 'Create a job'.

Added technology preview operation 'Get a Job'.

Added technology preview operation 'Get job progress'.

Added technology preview operation 'Delete Job'.

Added technology preview operation 'Modify a job'.

This information is included in every event the webhook will receive.

base-event

content

object

eventType

string

enqueuedDateTime

iTwinId

messageId

webhookId

Base Event

Event that gets triggered when a reality conversion job is complete

realityConversion.jobCompleted.v1-event

Globally Unique Identifier of the reality conversion job.

jobId

realityConversion.jobCompleted.v1

---

Create a new job to convert point cloud formats to web-friendly Orbit Point Cloud or Cesium 3D Point Cloud. The POST request body MUST include type, name, inputs and outputs.
Accepted input formats for conversion are LAS, LAZ, PLY, E57 and ouput formats are OPC and PNTS.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `realityconversion: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 `realityconversion:modify`

Authorization

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

Accept

My first RCS job

default

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.

HeaderNotFound

application/json;InvalidAuthorizationScheme

InvalidAuthorizationScheme

InvalidHeaderValue

RequiredScopeMissing

Unauthorized

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).

application/json;InvalidRealityConversionRequest

InvalidRealityConversionRequest

MissingRequestBody

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. Job will not be deleted once it is in active state.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `realityconversion: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

Job cannot be deleted once it has been submitted.

---

Retrieve job details.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `realityconversion: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 `realityconversion:read`

---

Retrieve job progress.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `realityconversion: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 can be used for changing the job state (to active or cancelled), updating job type, inputs , outputs, options or changing cost estimation parameters.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `realityconversion:modify`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---


Changelog

Oct 16, 2023

Nov 21, 2022