Autodesk plans to deprecate the legacy Object Storage Service (OSS) version 1 (v1) endpoints. The OSS v1 endpoints were introduced in the early stages of the OSS API (known as View and Data). In 2016, we introduced version 2 (v2) endpoints, which are more robust and secure. The v2 endpoints are designed to meet modern integration needs and ensure long-term support.
Action Required
If your application is still using v1 version of the OSS API, you must migrate to v2 version by October 31, 2025, after which v1 endpoints will stop functioning.
Based on our usage data, we’ve identified that the following five v1 endpoints are still being used by 3rd party applications:
- POST oss/v1/buckets (create a bucket)
- DELETE oss/v1/buckets/:bucketKey (delete a bucket)
- GET oss/v1/buckets/:bucketKey/objects/:objectKey/details (retrieve the detailed information about a given object.)
- GET oss/v1/buckets/:bucketKey/objects/:objectKey (download)
- PUT oss/v1/buckets/:bucketKey/objects/:objectKey (upload)
We recommend checking the usage of the above v1 endpoints and migrating to v2 as soon as possible.
Migration Guidance
To help with your migration efforts, here are the recommended v2 equivalents and the corresponding changes.
|
v1 Deprecated Endpoints |
Recommended v2 Replacement |
|
POST oss/v1/buckets (create a bucket) |
|
|
DELETE oss/v1/buckets/:bucketKey (delete a bucket) |
|
|
GET oss/v1/buckets/:bucketKey/objects/:objectKey/details (retrieve the detail information about a given object) |
|
|
GET oss/v1/buckets/:bucketKey/objects/:objectKey (download) |
Use direct S3 to download:
You can find a tutorial here. |
|
PUT /oss/v1/buckets/:bucketKey/objects/:objectKey (upload) |
Use direct S3 to upload:
You can find tutorials for uploading a file to a project here, and for app managed here for more information. |
If you have any questions regarding this deprecation, please contact APS support.
