Interact with your jobs and workspaces for Reality Modeling

Create, update, delete jobs and workspaces.

contextcapture

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 modeling job is complete

realityModeling.jobCompleted.v1-event

Globally Unique Identifier of the reality modeling job.

jobId

realityModeling.jobCompleted.v1

---

Create a new job

### Authentication

Requires `Authorization` header with valid Bearer token for scope `contextcapture: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 `contextcapture:modify`

Authorization

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

Accept

My first Reality Modeling 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;InvalidContextCaptureRequest

InvalidContextCaptureRequest

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

### Authentication

Requires `Authorization` header with valid Bearer token for scope `contextcapture: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.

### Parameters

The job id

### Authentication

Requires `Authorization` header with valid Bearer token for scope `contextcapture: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 `contextcapture: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 `contextcapture: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 a job to modify it (type, settings, cost estimation parameters), submit or cancel it.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `contextcapture: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

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


workspaces-create

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


workspaces-delete

---

Retrieve workspace information.

### Parameters

A workspace id.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `contextcapture:read`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---


workspaces-get

---

Retrieve the engines limit.

### Parameters

An optional projectId.

### Authentication

Requires `Authorization` header with valid Bearer token for scope `contextcapture:read`.

For more documentation on authorization and how to get access token visit [OAUTH2 Authorization](https://developer.bentley.com/apis/overview/authorization/) page.

---


limits-engines

Samples - Reality Modeling | iTwin Platform

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

Get started with Reality Modeling API

This tutorial focuses on using cache for faster processing in Reality Modeling

Using cache in Reality Modeling API

Learn how to specify calibration settings in Reality Modeling, and download the result of a calibration