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

contextcapture

# Reality Modeling API

The *Reality Modeling API* provides the ability to turn images and point clouds into reality meshes, orthophotos and other by-products.

*Reality Modeling* is articulated around workspaces and jobs. A *Reality Modeling* workspace is a way to regroup similar jobs, and create gateways between jobs. A _Reality Modeling_ job is a job using basic reality data inputs (Images, point clouds) to create specified outputs (meshes, orthophotos, point clouds, orientations). Note that in order to use *Reality Modeling*, you need to already know about *Reality Management* API (also known as *ProjectWise ContextShare*) in order to upload and download data.


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

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

application/json;InvalidContextCaptureRequest

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

iTwinId

Overview - 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

Better calibration in Reality Modeling

Learn how to specify production settings in Reality Modeling