Assistant usage API

Retrieve per-user AI assistant activity to monitor adoption trends and export daily usage snapshots.

Rejects an invalid date range

GET /api/v1/usage/assistant_users

Parameters
Name	Description
`start_at *`	ISO8601 timestamp that marks the start of the usage window
`end_at *`	ISO8601 timestamp that marks the end of the usage window
`page`	Optional page number for paginated results (default 1)
`per_page`	Optional page size (default 200, maximum enforced by the endpoint)

Example request

GET /api/v1/usage/assistant_users?start_at=2019-01-01T00%3A00%3A00Z&end_at=2019-01-01T00%3A00%3A00Z

Example CURL command

curl -g "https://company.aha.io/api/v1/usage/assistant_users?start_at=2019-01-01T00%3A00%3A00Z&end_at=2019-01-01T00%3A00%3A00Z" -X GET \
	-H "Authorization: Bearer 584b6d6b83405011f8c6903d2379f4afdf824cef867db391b7bcb5995f603a76" \
	-H "Content-Type: application/json" \
	-H "Accept: application/json"

Request

authorization: Bearer 584b6d6b83405011f8c6903d2379f4afdf824cef867db391b7bcb5995f603a76
contentType: application/json
accept: application/json

Response

Status: 422 Unprocessable Entity
contentType: application/json; charset=utf-8

Response body