---
title: "Update an app element reference."
method: POST
path: "/appelements/d/{did}/{wvm}/{wvmid}/e/{eid}/references/{rid}"
tags: ["AppElement"]
---

# Update an app element reference.

`POST /appelements/d/{did}/{wvm}/{wvmid}/e/{eid}/references/{rid}`

## Request

- Base URL: `https://api.onshape.com/api/v17`
- URL: `https://api.onshape.com/api/v17/appelements/d/{did}/{wvm}/{wvmid}/e/{eid}/references/{rid}`
- Auth: OAuth 2 and HTTP basic
  - Authorization code: `/oauth/authorize`
  - Token URL: `/oauth/token` scopes: `OAuth2Write`

## Path parameters

- `did` string, required
- `eid` string, required
- `wvm` string, required
- `wvmid` string, required
- `rid` string, required

## Request body

- BTAppElementReferenceParams
  - `hasDocumentMicroversions` boolean
  - `idTag` string
  - `idTagMicroversionId` string
  - `isLocked` boolean
  - `isSketchOnly` boolean
  - `parentChangeId` string
  - `parentViewId` string
  - `partNumber` string
  - `pureSketch` boolean
  - `referenceType` integer
  - `returnError` boolean
  - `revision` string
  - `sketchIds` string[]
  - `targetConfiguration` string
  - `targetDocumentId` string
  - `targetElementId` string
  - `targetMicroversionId` string
  - `targetVersionId` string
  - `trackNewVersions` boolean
  - `transactionId` string
  - `updateSketchInfo` boolean

## Response `default`

default response

---

[API](https://skmtc.dev/onshape/apis/onshape-rest-api.md) - [All operations](https://skmtc.dev/onshape/apis/onshape-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/onshape/apis/onshape-rest-api/revisions/c5c4c780f831?raw)