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

realityconversion

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

base-event

content

object

Base Event eventType

base-event-eventType

enqueuedDateTime

string

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

Added technology preview operation 'Get jobs'.

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

realityconversion-pr460950

realityconversion-rcsGetJobsEndpoint

realityconversion-rcs-mandate-itwin-id

shubhamk-rcs-mandate-itwin-id

---

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 `itwin-platform`.

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 `itwin-platform` scope

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

InvalidAuthorizationScheme

InvalidHeaderValue

RequiredScopeMissing

Unauthorized

InvalidApplicationTier

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

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 `itwin-platform`.

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 `itwin-platform`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---


jobs-get

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

jobs-progress

---

Retrieve list of jobs matching provided filter.

The `iTwinId` in filter is optional. If it is not provided, this will return jobs created by the same user. However, if the iTwinId is provided and the user has access to it, this will return jobs associated with that specific iTwin.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `itwin-platform`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---

jobs-get-all

The $filter query option requests a specific set of jobs.
The given filter is evaluated for each job and only job where the filter evaluates to true are returned.
Properties supported for filtering: `id`, `iTwinId`, `name`, `email`, `type`, `state`, `createdDateTime`, `inputId`, `outputId`.
Supported operators: `eq`, `lt`, `le`, `gt`, `ge`, `ne`, `in`, `and`, `or`.
 Samples of $filter values:
`$filter=iTwinId eq dc720f05-e5f7-448b-ae06-765de46f0af1`
`$filter=inputId in ('482b2968-6a85-4e50-b05c-8acbf828c1bd', '14c03448-bea0-4d76-b53b-4b20bd3f4cbc')`
`$filter=id eq 9e2d27cf-b695-47e9-b7f0-0d47dc3b88ad`
`$filter=createdDateTime gt 2024-06-24T13:00:00Z`


$filter

Parameter that enables continuing to the next page of the previous paged query. This must be passed exactly as it is in the response body's _links.next property.

continuationToken

The number of reality conversion jobs to get in each page. Max 1000, but 100 is the default if this parameter is not included.

$top

---

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 `itwin-platform`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---


Changelog

Sep 20, 2024

Sep 13, 2024

Oct 16, 2023

Nov 21, 2022