27 Apr 2023

Parameters API (beta) Update

Default blog image

Updated May 15, 2023:

Parameters Services has gone through the data migration on backend. Parameters API, which is used behind the feature and is currently public beta, has been updated.   
 

Are you using Parameters API, which is current in beta stage? Or are you actively looking at the API? If so, please read on.

As announced in the Parameters API feedback portal, Parameters Service has the data migration planned on May 12, and Parameters API (beta) v1 is going to change at that time. Please be aware that this is a breaking change for this API.

There are two areas of changes:

  • Base URL includes “/groups/” after “/accounts/:accountId/”. e.g., 
    from:
    GET https://developer.api.autodesk.com/parameters/v1/accounts/{accountId}/collections
    to:  
    https://developer.api.autodesk.com/parameters/v1/accounts/{accountId}/groups/{groupId}/collections
     
  • POST create parameters API accepts only the following core definition fields (which were marked as required previously) as input: i.e., id, name, dataTypeId and readOnly. The metadata and description (which were optional before) can be added/updated with PATCH modify parameters endpoint.

Note that the version number stays as “v1”.  (We are taking advantage of being beta stage. We have also contacted active users of the API. We will make sure we will use versioning and provide enough deprecation period once the API is officially released.)  

There are three additional endpoints for groups:

  • GET    https://developer.api.autodesk.com/parameters/v1/accounts/{accountId}/groups
  • GET    https://developer.api.autodesk.com/parameters/v1/accounts/{accountId}/groups/{groupId}
  • PUT    https://developer.api.autodesk.com/parameters/v1/accounts/{accountId}/groups/{groupId}

If you have any questions regarding Parameters API, please make use of feedback portal to contact the product team directly or e-mail us at aps.help@autodesk.com.

 

Related Article

Posted By

Mikako Harada

Mikako Harada

Mikako Harada works as an AEC technical lead and Americas manager for the Developer Technical Services (DevTech) team at Autodesk. She provides API (Application Programming Interface) technical support to the members of Autodesk Developer Network worldwide for AEC products. Prior to joining Autodesk, she worked as a researcher for the Swiss Federal Institute of Technology (ETH) in Zurich. While at ETH, she...

Zhong Wu

Zhong Wu started his career in Autodesk since 2006 on AutoCAD Architecture as a software developer with more than 6 years working experience. After that, Zhong moved to Autodesk Development Network(now is renamed to Forge Partner Development) team as a Developer Advocate mainly focus on the API support/consultant for Maya/MotionBuilder, and started to contribute in Forge evangelism and support with the growing...