Skip to Main Content

Share your product feedback

Status Future consideration
Categories API
Created by Dale Potter
Created on Oct 28, 2025

Expand payload response in "Assistant usage API" endpoint

What is the challenge?

Using the "Assistant usage API" endpoint to extract usage of the AI assistant into a 3rd party database, to be used to create a usage dashboard. There are certain data points not present in the response payload, which is making it difficult to easily build the dashboard.

What is the impact?

There is a possibility that the data in the dashboard is not entirely accurate

Describe your idea

1. Return "start_at" and "end_at" in the payload response

2. Add "group by" functionality to group the results in the payload by day

  • Attach files
  • Venkat Reddy Avuluri
    Oct 29, 2025

    I’d like to suggest a few points to the endpoint (e.g., https://www.aha.io/api/resources/assistant_usage/list_assistant_users_within_a_time_window):

    1. Echo Input Parameters in Output
      While the API accepts start_at and end_at as input parameters, it would be helpful if these values were also included in the response payload. This would provide clarity on the timeframe covered when reviewing the results, especially in automated reporting or auditing scenarios.

    2. Grouping by Timeframe
      Adding the ability to group results by a functional time unit—such as day, week, or month—based on the activity timestamp would be ideal. This would allow for more flexible analysis and visualization of usage trends.

    3. Detailed Activity Records
      Alternatively, returning all activity details with their respective timestamps would also work, provided the volume of records remains manageable. This would give consumers of the API the flexibility to perform their own grouping or filtering as needed.

    These enhancements would significantly improve usability and clarity for teams analyzing assistant usage data.

  • +1