---
title: "POST /documents/d/{did}/w/{wid}/revertunchangedtorevisions"
method: POST
path: "/documents/d/{did}/w/{wid}/revertunchangedtorevisions"
tags: ["Document"]
---

# POST /documents/d/{did}/w/{wid}/revertunchangedtorevisions

`POST /documents/d/{did}/w/{wid}/revertunchangedtorevisions`

## Request

- Base URL: `https://api.onshape.com/api/v17`
- URL: `https://api.onshape.com/api/v17/documents/d/{did}/w/{wid}/revertunchangedtorevisions`
- Auth: OAuth 2 and HTTP basic
  - Authorization code: `/oauth/authorize`
  - Token URL: `/oauth/token` scopes: `OAuth2Write`

## Path parameters

- `did` string, required
- `wid` string, required

## Request body

- BTRevertUnchangedParams
  - `companyId` string
  - `connectionId` string
  - `doUpdate` boolean
  - `elements` BTRevertUnchangedElementParams[]
    - `configuration` string
    - `elementId` string
    - `referenceIds` string[]

## Response `default`

default response

- BTUnchangedElementInfo[]
  - `connectionId` string
  - `elementId` string
  - `unchangedReferences` BTUnchangedReferenceInfo[]
    - `metadataUnchanged` boolean
    - `nodeIds` string[]
    - `toRevision` BTRevisionInfo: Revision details.
      - `approvers` BTRevisionApproverInfo[]: The users who approved the release package that created this revision.
        - `date` string, date-time: Date the revision was created.
        - `id` string: User ID of the user who approved the revision.
        - `name` string: Name of the user who approved the revision.
      - `autoObsoletionReleaseId` string
      - `autoObsoletionReleaseName` string
      - `canChangeType` boolean: Whether the revision can change object type. Used in reuse part number flow.
      - `canExport` boolean
      - `companyId` string: The company or enterprise ID that owns the resource.
      - `configuration` string
      - `createdAt` string, date-time
      - `description` string: The Revision Description metadata property if revision is of a drawing.
      - `documentId` string: The document that contains the revision object.
      - `documentName` string: The name of the document that contains the revision object.
      - `documentState` integer: The state of document containing this revision. Used in reuse part number flow
      - `elementId` string: The element that contains the revision object.
      - `elementType` integer: The type of item Element Type. Must be one of: `-1`: Unknown, `0`: Part Studio, `1`: Assembly, `2`: Drawing. `4` : Blob, `8`: Variable Studio
      - `errorMessage` string
      - `flatPartInsertableId` string
      - `href` string, uri: URI to fetch complete information of the resource.
      - `id` string: Id of the resource.
      - `insertableId` string
      - `isObsolete` boolean: Whether the revision has been obsoleted.
      - `isRereleasable` boolean: If true, the revision can be created again.
      - `isTranslatable` boolean
      - `mimeType` string
      - `name` string: Name of the resource.
      - `nextRevisionId` string: The next revision if applicable. null for the latest revision.
      - `obsoletionPackageId` string: The OBSOLETION release package that obsoleted this revision if applicable.
      - `partId` string
      - `partIdentity` string
      - `partNumber` string: The part number with which the object was revised.
      - `previousRevisionId` string: The previous revision if applicable. null for first revision.
      - `releaseCreatedDate` string, date-time
      - `releaseId` string: The release package that created this revision.
      - `releaseName` string: The name of the release package that created this item.
      - `releasedBy` BTUserSummaryInfo
        - `jsonType` string, required
        - `href` string, uri: URI to fetch complete information of the resource.
        - `id` string: Id of the resource.
        - `name` string: Name of the resource.
        - `viewRef` string, uri: URI to visualize the resource in a webclient if applicable.
        - `image` string
        - `isOnshapeSupport` boolean
        - `state` integer
        - `documentationName` string
        - `email` string
        - `firstName` string
        - `lastName` string
        - `company` BTCompanySummaryInfo
          - `admin` boolean
          - `awsCmkKmsArn` string
          - `description` string
          - `domainPrefix` string
          - `enterpriseBaseUrl` string
          - `enterpriseSubtype` integer
          - `href` string, uri: URI to fetch complete information of the resource.
          - `id` string: Id of the resource.
          - `image` string
          - `name` string: Name of the resource.
          - `noPublicDocuments` boolean
          - `ownerId` string
          - `secondaryDomainPrefixes` string[]
          - `state` integer
          - `type` integer
          - `viewRef` string, uri: URI to visualize the resource in a webclient if applicable.
        - `companyUserState` integer
        - `confirmationRequested` boolean
        - `documentationNameOverride` string
        - `globalPermissions` GlobalPermissionInfo
          - `accessReports` boolean
          - `adminEnterprise` boolean
          - `allowAppStoreAccess` boolean
          - `allowPublicDocumentsAccess` boolean
          - `approveReleases` boolean
          - `branchLockPermissions` boolean
          - `createDocumentsInRoot` boolean
          - `createProject` boolean
          - `createReleases` boolean
          - `createTasks` boolean
          - `deletePermanently` boolean
          - `enableLabs` boolean
          - `exportFiles` boolean
          - `importFiles` boolean
          - `manageGuestUsers` boolean
          - `manageNonGeometricItems` boolean
          - `manageRbac` boolean
          - `manageStandardContentMetadata` boolean
          - `manageUsers` boolean
          - `manageWorkflows` boolean
          - `shareForAnonymousAccess` boolean
          - `transferDocumentsFromEnterprise` boolean
          - `useRevisionTools` boolean
        - `invitationState` integer
        - `isExternal` boolean
        - `isGuest` boolean
        - `isLight` boolean
        - `lastLoginTime` string, date-time
        - `personalMessageAllowed` boolean
        - `scheduledRemovalDate` string, date-time
        - `showOffBoardingNotification` boolean
        - `source` integer
      - `revision` string: The id of the revision.
      - `revisionRuleId` string
      - `versionId` string: The version of the document that contains this revision.
      - `versionName` string: The name of the version of the document that contains this revision.
      - `viewRef` string, uri: URI to visualize the resource in a webclient if applicable.

---

[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/5fa7a57a26dd?raw)
