API News - March 2022

A reminder about Workflows API changes, a new API to see who's active and logging in, and improvements to List Documents and List Drawings.

 

Reminder about Workflows API changes

  • A reminder that the current Workflows API will be decommissioned on May 31, 2022.
  • If you haven't already migrated to the new Workflows API, now is the perfect time to start. 
  • We've made it easy to migrate with the same endpoints and filters, however, there's a slight URL change.
  • Find out more in the updated Workflows API Developer Guide.

 

See who's active and logging in to Aconex

  • We've added the new List Organization Users API within the Directory APIs.
  • Org admins can see who's active within their organization and when they last accessed Aconex.
  • The API lists all an org's users, their status (enabled or disabled and locked or unlocked), if they're a guest user, and the last date they logged on.
  • Only org admin users can use this API.
  • View the Directory API Developer Guide

 

Transfer-Encoding for List Documents and List Drawings

  • Transfer-Encoding (Chunked Response) has been added to support long responses. 
  • Also added for View Document Schema, View Document Metadata, View Document Event Log, and Documents Last Updated.
  • View the Documents API Documentation

 

Pagination and improved filtering for All Filters List Documents

  • New response fields for pagination are: totalResultsCount, totalResultsOnCurrentPage, totalNumberOfPages, currentPageNumber.
  • A new request field "returnCurrentSetDocsOnly" allows you to return only "CurrentSet" Documents. 
  • Multiple Values (comma separated) can now be specified in the search filter for MultipleSelect List fields.
  • View the Documents API Documentation

 

Authenticating with Lobby accounts

  • You may be aware that the Lobby allows users to manage accounts across multiple organizations or Aconex instances. 
  • Please note that Aconex APIs are not currently accessible with Lobby accounts. 
  • For the moment, API users should continue to use their Aconex username to authenticate, whether using Basic Auth or OAuth. 
  • Learn more about the Lobby

 

A reminder about Aconex project locations (instances)

  • If you haven’t updated your APIs in a while, you may want to review to ensure you’re including all Aconex project locations (instances).
  • In the last couple of years, we’ve added (Europe) EU1 and (Canada) CA1.
  • See the full list of Aconex instances / project locations on Support Central