January 29, 2025 Upcoming changes to Audits API

As part of ongoing security improvements and feature enhancements, we are changing how you access audit logs of activity in your Aha! account through the Aha! API. Starting March 1, 2025, the audits API endpoint will return data from the prior 365 days. A new endpoint, historical_audits, will return activity that is more than a year old.

Click any of the following links to skip ahead:

What is changing?

We are changing the audits API in the following ways:

  1. The current audits API endpoint was not publicly documented and supported. Now, there is new documentation for this API.

  2. The current audits API endpoint will soon support fetching change records created only within the last year. This change is scheduled for March 1, 2025.

  3. The historical audits API endpoint will launch, providing access to older historical records. However, this endpoint will be heavily rate limited and will have an asynchronous query interface requiring additional development time to implement.

Top

When is it changing?

March 1, 2025

Top

Who is affected?

Aha! account administrators who use the Aha! API to review historical change data

Top

What do I need to do?

If you only need to review change data from the last 365 days, you may still use the audits API. If you want to review change data that is more than 365 days old, you have two options:

  1. Implement the activity webhook functionality to capture and store historical events within your own system.

  2. Change your implementation to use the new historical audits API.

Top