Apply Previous Plugs
Bids
POST
bids/{bidId}/apply-previous-plugs
Apply plugs, highlights, and notes from a previous revision to the specified bid. This replaces all existing plugs, highlights, and notes.
Resource Information
| Method and URI | POST https://developer.api.autodesk.com/construction/buildingconnected/v2/bids/{bidId}/apply-previous-plugs |
| Authentication Context | User context required |
| Required OAuth Scopes | data:write |
| Data Format | JSON |
Request
Headers
| Authorization* string | Must be Bearer <token>, where <token> is a three-legged access token obtained via an Authorization Code flow. |
| Content-Type* string | Must be application/json |
* Required
Request
URI Parameters
| bidId string | The unique ID of the bid. |
Request
Body Structure
| revision* int | The revision number from which you want to copy plugs. Set to -1 to copy plugs from the latest previous revision. The revision number must be less than the revision number of the specified bid.
Note that the first bid has a revision number of |
* Required
Response
HTTP Status Code Summary
| 204 No Content | No Content |
| 400 Bad Request | The parameters of the requested operation are invalid. |
| 401 Unauthorized | The provided bearer token is not valid. |
| 403 Forbidden | The user or service represented by the bearer token does not have permission to perform this operation. |
| 404 Not Found | The requested resource could not be found. |
| 429 Too Many Requests | Rate limit exceeded; wait some time before retrying. The ‘Retry-After’ header might provide the amount of the time to wait. |
| 500 Internal Server Error | An unknown error occurred on the server. |
Response
Body Structure (204)
Response for 204 has no body.
Example
No Content
Request
curl -v 'https://developer.api.autodesk.com/construction/buildingconnected/v2/bids/:bidId/apply-previous-plugs' \
-X 'POST' \
-H 'Authorization: Bearer AuIPTf4KYLTYGVnOHQ0cuolwCW2a' \
-H 'Content-Type: application/json' \
-d '{
"revision": -1
}'
Response
204 No Content