Hide Table of Contents
PDM Pro API Web Service
PDM Pro API Web Service
Description
The PDM Professional API Web Service consists of controllers and endpoints.
Authentication
Postapi/{vaultName}/authenticate
POST: api/{VaultName}/authenticate Use for the authenticate to get authentication token

 

Authenticates the specified login for the specified vault and returns the authentication token and status.

BOM
Getapi/{vaultName}/bom/{bomDocumentId}/{version}/{folderId}/named
GET: api/{VaultName}/bom/{BomDocumentId}/{Version}/{FolderID}/named Get named bom

 

Gets the specified BOM.

Getapi/{vaultName}/bom/{bomTypeId}/{fileId}/{version}/{folderId}/computed?configId={configId}&latest={latest}
GET: api/{VaultName}/bom/{BomTypeId}/{FileID}/{Version}/{FolderID}/weldmentcutlist or api/{VaultName}/bom/{BomTypeId}/{FileID}/{Version}/{FolderID}/computed Get computed BOM

 

Gets the computed BOM.

Getapi/{vaultName}/bom/{bomTypeId}/{fileId}/{version}/{folderId}/weldmentcutlist?configId={configId}&latest={latest}
GET: api/{VaultName}/bom/{BomTypeId}/{FileID}/{Version}/{FolderID}/weldmentcutlist or api/{VaultName}/bom/{BomTypeId}/{FileID}/{Version}/{FolderID}/computed Get computed BOM

 

Gets the weldment cut list BOM.

Configuration
Getapi/configuration/vaults?vaultName={vaultName}
GET: api/configuration/vaults Get all vaults from the config file

 

Gets all vaults from the vault configuration file.

Data Card
Getapi/{vaultName}/files/{fileId}/{version}/datacard?folderId={folderId}
GET: api/{VaultName}/files/{FileID}/{Version}/datacard Get file data card

 

Gets the data card for the specified file, file version, and vault.

Postapi/{vaultName}/files/{fileId}/datacard
POST: api/{VaultName}/files/{FileID}/datacard Save file data card

 

Saves the data card for the specified file and vault.

Getapi/{vaultName}/folders/{folderId}/datacard
GET: api/{VaultName}/folders/{FolderID}/datacard Get folder data card

 

Gets the data card for the specified folder and vault.

Default
Getapi/{uri}

 

Uses the specified URI to get information.

Postapi/{uri}

 

Uses the specified URI to post information.

Putapi/{uri}

 

Uses the specified URI to save information.

Patchapi/{uri}

 

Uses the specified URI to patch information.

Deleteapi/{uri}

 

Uses the specified URI to delete information.

File
Getapi/{vaultName}/files/{fileId}/{version}
GET: api/{VaultName}/files/{FileID} or api/{VaultName}/files/{FileID}/{Version}/info Get file info

 

Gets information about the specified file.

Getapi/{vaultName}/files/{fileId}/{version}/ActiveConfig
GET: api/{vaultName}/files/{FileID}/{Version}/ActiveConfig Get active configuration

 

Gets the active configuration of the specified file.

Getapi/{vaultName}/files/{fileId}/{version}/allreferences?configId={configId}&folderId={folderId}&includeSubParents={includeSubParents}
GET: api/{VaultName}/files/{FileID}/{Version}/allreferences Get all file references

 

Gets the reference tree of the specified file.

Getapi/{vaultName}/files/{fileId}/{version}/configurations
GET: api/{VaultName}/files/{FileID}/{Version}/configurations Get file configurations

 

Gets the configurations of the specified file.

Getapi/{vaultName}/files/{fileId}/{version}/download
GET: api/{VaultName}/files/{FileID}/{Version}/download Get file

 

Gets the link to download a file.

Getapi/{vaultName}/files/{fileId}/{version}/info
GET: api/{VaultName}/files/{FileID} or api/{VaultName}/files/{FileID}/{Version}/info Get file info

 

Gets information about the specified file.

Getapi/{vaultName}/files/{fileId}/{version}/info/extended
GET: api/{VaultName}/files/{FileID}/{Version}/info/extended Get file info extended

 

Gets extended file information.

Getapi/{vaultName}/files/{fileId}/{version}/references?configId={configId}&folderId={folderId}
GET: api/{VaultName}/files/{FileID}/{Version}/references Get file references

 

Gets the top level file references of the specified file.

Getapi/{vaultName}/files/{fileId}/{version}/thumbnails
GET: api/{VaultName}/files/{FileID}/{Version}/thumbnails

 

Gets the link to download a file thumbnail.

Getapi/{vaultName}/files/{fileId}/{version}/variables
GET: api/{VaultName}/files/{FileID}/{Version}/variables Get file variables

 

Gets the specified file's variables.

Getapi/{vaultName}/files/{fileId}/{version}/whereused?configId={configId}&folderId={folderId}&anyVersion={anyVersion}
GET: api/{VaultName}/files/{FileID}/{Version}/whereused Get file where used

 

Gets the parents of the specified file.

Getapi/{vaultName}/files/{fileId}/bominfo?folderId={folderId}
GET: api/{VaultName}/files/{FileID}/bominfo Get file BOM info

 

Gets the BOM information for the specified file.

Getapi/{vaultName}/files/{fileId}/info?version={version}
GET: api/{VaultName}/files/{FileID} or api/{VaultName}/files/{FileID}/{Version}/info Get file info

 

Gets information about the specified file.

Getapi/{vaultName}/files/{fileId}/transitions?version={version}
GET: api/{VaultName}/files/{FileID}/transitions Get file transitions

 

Gets the state transitions for the specified file.

Getapi/{vaultName}/files/{fileId}/versions?folderId={folderId}
GET: api/{VaultName}/files/{FileID}/versions Get file version info

 

Gets the specified file's version information.

Deleteapi/{vaultName}/files/{fileId}?destroy={destroy}
DELETE: api/{VaultName}/files/{FileID} Delete file

 

Deletes the specified file

Getapi/{vaultName}/files/{fileId}?version={version}
GET: api/{VaultName}/files/{FileID} or api/{VaultName}/files/{FileID}/{Version}/info Get file info

 

Gets information about the specified file.

Putapi/{vaultName}/files/{parentFolderId}

 

Adds a file to the specified folder.

Postapi/{vaultName}/files/buildtree/checkout
POST: api/{VaultName}/files/buildtree/checkout Build checkout references tree

 

Gets the tree of references in the specified file's checkout.

Postapi/{vaultName}/files/buildtree/undo
POST: api/{VaultName}/files/buildtree/undo Build undo checkout references tree

 

Builds the reference tree to undo the checkout of the specified file.

Postapi/{vaultName}/files/CheckOut
POST: api/{VaultName}/files/CheckOut Lock file

 

Checks out the specified file.

Postapi/{vaultName}/files/info
POST: api/{VaultName}/files/info

 

Gets information about multiple files.

Postapi/{vaultName}/files/UndoCheckOut
POST: api/{VaultName}/files/UndoCheckOut Undo lock file

 

Unlocks the specified file.

Folder
Getapi/{vaultName}/folders/{folderId}
GET: api/{VaultName}/folders/{FolderID} or api/{VaultName}/folders/{FolderID}/info Get folder info

 

Gets information for the specified folder.

Getapi/{vaultName}/folders/{folderId}/browse
GET: api/{VaultName}/folders/{FolderID}/browse Get browse folder

 

Gets the files and folders in the specified folder.

Getapi/{vaultName}/folders/{folderId}/info
GET: api/{VaultName}/folders/{FolderID} or api/{VaultName}/folders/{FolderID}/info Get folder info

 

Gets information for the specified folder.

Deleteapi/{vaultName}/folders/{folderId}?destroy={destroy}
DELETE: api/{VaultName}/folders/{FolderID} Delete folder

 

Deletes the specified folder.

Putapi/{vaultName}/folders/{parentFolderId}
PUT: api/{VaultName}/folders/{ParentFolderID} Add folder

 

Adds a folder to the specified folder.

Postapi/{vaultName}/folders/info
POST: api/{VaultName}/folders/info Get folder info

 

Gets information about specified folders in the specified vault.

Group
Getapi/{vaultName}/groups
GET: api/{VaultName}/groups or api/{VaultName}/groups/all Get groups

 

Gets the groups in the specified vault.

Getapi/{vaultName}/groups/{groupId}
GET: api/{VaultName}/groups/{GroupID} or api/{VaultName}/groups/{GroupID}/info Get group info

 

Gets information about the specified group.

Getapi/{vaultName}/groups/{groupId}/info
GET: api/{VaultName}/groups/{GroupID} or api/{VaultName}/groups/{GroupID}/info Get group info

 

Gets information about the specified group.

Getapi/{vaultName}/groups/all
GET: api/{VaultName}/groups or api/{VaultName}/groups/all Get groups

 

Gets the groups in the specified vault.

Notification
Postapi/{vaultName}/notifications
POST: api/{VaultName}/notifications Send message

 

Sends the specified message.

Postapi/{vaultName}/notifications/markRead
POST: api/{vaultName}/notifications/markRead Mark message as read

 

Marks a notification as read.

Getapi/{vaultName}/notifications?all={all}&pageNo={pageNo}&pageSize={pageSize}
GET: api/{VaultName}/notifications Get user notifications

 

Gets the user notifications.

Progress
Getapi/{vaultName}/progress/{guid}/result
GET: api/{vaultName}/progress/{guid}/result

 

Gets the result of the specified operation.

Getapi/{vaultName}/progress/{guid}/status
GET: api/{vaultName}/progress/{guid}/status Get operation status

 

Gets the status of the specified operation.

Stage
Getapi/{vaultName}/changeset/create
GET: api/{vaultName}/changeset/create Generate changesetId

 

Gets a changeset ID for the specified vault.

Putapi/{vaultName}/checkin/{changesetId}/{overrideVersion}
PUT: api/{vaultName}/checkin/{changesetId}/{overrideVersion=false} Check in files from the changeset

 

Checks in the specified changeset.

Putapi/{vaultName}/checkin/addfiles/{changesetId}
PUT: api/{vaultname}/checkin/addfiles/{changesetId=0} Upload files or document ids to changeset to the check in operation

 

Uploads files to the specified changeset for checkin.

Getapi/{vaultName}/checkin/buildtree/{changesetId}
GET: api/{vaultName}/checkin/buildtree/{changesetId} Get references tree

 

Builds a reference tree of files that are uploaded to the specified changeset.

Putapi/{vaultName}/files/{changesetId}/finishadd
PUT: api/{vaultName}/files/{changesetId}/finishadd Finish of add file operation. This method adds files from changeset to the vault.

 

Adds files in the specified changeset to the vault.

Putapi/{vaultName}/files/{changesetId}/upload
PUT: api/{vaultname}/files/{changesetId}/upload Upload file to changeset to add files operations

 

Uploads a changeset.

Putapi/{vaultName}/files/{folderId}/new
PUT: api/{vaultName}/files/{folderId}/new Add single file to vault

 

Adds a file to the specified folder in the specified vault.

Putapi/stage/{vaultName}/{documentId}?folderId={folderId}&overrideVersion={overrideVersion}

 

Checks in the specified document.

State Transition
Getapi/{vaultName}/state/{documentId}/{folderId}/{transitionId}/references
GET: api/{vaultName}/state/{documentId}/{folderId}/{transitionId}/references Get all references

 

Gets all references for the specified file and transition.

Getapi/{vaultName}/state/{documentId}/transitions
GET: api/{vaultName}/state/{documentId}/transitions Get available transitions for single file

 

Gets the transitions available for the specified file.

Getapi/{vaultName}/state/{transitionId}
GET: api/{vaultName}/state/{transitionId} Get transition info

 

Gets information about the specified transition.

Postapi/{vaultName}/state/{transitionId}/changestate?revoke={revoke}
POST: api/{vaultName}/state/{transitionId}/changestate Change state

 

Changes the state of the specified documents.

Postapi/{vaultName}/state/{transitionId}/DynamicNotificationUsers
POST: api/{vaultName}/state/{transitionId}/DynamicNotificationUsers Get dynamic notification users

 

Gets the users to notify when the specified items undergo the specified transition.

Postapi/{vaultName}/state/{transitionId}/HistoryComments
POST: api/{vaultName}/state/{transitionId}/HistoryComments Get transition comment history for multiple files

 

Gets the comment histories for specified files that undergo the specified transition.

Postapi/{vaultName}/state/transitions
POST: api/{vaultName}/state/transitions Get available transitions for multiple files

 

Gets the transitions available for multiple files.

User
Getapi/{vaultName}/users
GET: api/{VaultName}/users or api/{VaultName}/users/all Get users

 

Gets the users of the specified vault.

Getapi/{vaultName}/users/{userId}
GET: api/{VaultName}/users/{UserID} or api/{VaultName}/users/{UserID}/info Get user info

 

Gets information about the specified user.

Getapi/{vaultName}/users/{userId}/Extended
GET: api/{VaultName}/users/{UserID}/Extended Get user info extended

 

Gets extended information about the specified user.

Putapi/{vaultName}/users/{userId}/Extended
PUT: api/{VaultName}/users/{UserID}/Extended Set user info extended

 

Saves information about the specified user.

Getapi/{vaultName}/users/{userId}/info
GET: api/{VaultName}/users/{UserID} or api/{VaultName}/users/{UserID}/info Get user info

 

Gets information about the specified user.

Getapi/{vaultName}/users/{userId}/Picture
GET: api/{VaultName}/users/{UserID}/Picture Get user picture

 

Gets the picture of the specified user.

Putapi/{vaultName}/users/{userId}/Picture
PUT: api/{VaultName}/users/{UserID}/Picture Put user picture

 

Saves the picture of the specified user.

Deleteapi/{vaultName}/users/{userId}/Picture
DELETE: api/{VaultName}/users/{UserID}/Picture Delete user picture

 

Deletes the picture of the specified user.

Getapi/{vaultName}/users/all
GET: api/{VaultName}/users or api/{VaultName}/users/all Get users

 

Gets the users of the specified vault.

Vault
Getapi/{vaultName}
GET: api/{VaultName} or api/{VaultName}/info Get vault properties

 

Gets the properties of the specified vault.

Postapi/{vaultName}/delete/computetree
POST: api/{VaultName}/delete/computetree Delete compute tree

 

Deletes the specified items in the specified vault.

Getapi/{vaultName}/info
GET: api/{VaultName} or api/{VaultName}/info Get vault properties

 

Gets the properties of the specified vault.

Getapi/{vaultName}/search
GET: api/{VaultName}/search Search vault

 

Gets objects in the specified vault.

Postapi/{vaultName}/search
POST: api/{VaultName}/search Search vault

 

Gets objects in the vault that contain the specified string.

Version
Getapi/version/webapi
GET: api/version/webapi Get version

 

Gets the version of this web application.

Workflow
Getapi/{vaultName}/workflows
GET: api/{VaultName}/workflows Get workflows

 

Gets the workflows in the specified vault.

Getapi/{vaultName}/workflows/icons
GET: api/{vaultName}/workflows/icons Get state icons

 

Gets the workflow state icons in the specified vault.



Provide feedback on this topic

SOLIDWORKS welcomes your feedback concerning the presentation, accuracy, and thoroughness of the documentation. Use the form below to send your comments and suggestions about this topic directly to our documentation team. The documentation team cannot answer technical support questions. Click here for information about technical support.

* Required

 
*Email:  
Subject:   Feedback on Help Topics
Page:   PDM Pro API Web Service
*Comment:  
*   I acknowledge I have read and I hereby accept the privacy policy under which my Personal Data will be used by Dassault Systèmes

Print Topic

Select the scope of content to print:




x

We have detected you are using a browser version older than Internet Explorer 7. For optimized display, we suggest upgrading your browser to Internet Explorer 7 or newer.

 Never show this message again
x

Web Help Content Version: API Help (English only) 2022 SP02

To disable Web help from within SOLIDWORKS and use local help instead, click Help > Use SOLIDWORKS Web Help.

To report problems encountered with the Web help interface and search, contact your local support representative. To provide feedback on individual help topics, use the “Feedback on this topic” link on the individual topic page.