13 Jun 2025

Object Storage Service (OSS) API: deprecating v1 endpoints

Default blog image

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) 

POST oss/v2/buckets 

DELETE oss/v1/buckets/:bucketKey (delete a bucket) 

DELETE oss/v2/buckets/:bucketKey  

GET oss/v1/buckets/:bucketKey/objects/:objectKey/details (retrieve the detail information about a given object) 

GET oss/v2/buckets/:bucketKey/objects/:objectKey/details 

GET oss/v1/buckets/:bucketKey/objects/:objectKey (download)  

Use direct S3 to download: 

  1. GET oss/v2/buckets/:bucketKey/objects/:objectKey/signeds3download 

  1. Use the signed URL returned by the above and make a request to AWS S3. 

You can find a tutorial here.  

PUT /oss/v1/buckets/:bucketKey/objects/:objectKey (upload) 

Use direct S3 to upload: 

  1. GET oss/v2/buckets/:bucketKey/objects/:objectKey/signeds3upload 

  1. Upload the file to S3 using the pre-signed S3 URL obtained above. 

  1. POST oss/v2/buckets/:bucketKey/objects/:objectKey/signeds3upload 

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.

Related Article