New AI Tools Summary
GET /clients/{client_id}/analytics/apps/ai/recent/summary
This endpoint is fully redundant. Use the generic App Utilization Summary with ?category_ids=<ai_id>.
Replacement:
GET /clients/{client_id}/analytics/apps/utilization/summary?category_ids=<ai_id>
Field mapping:
| This endpoint | Replacement | Notes |
|---|---|---|
total_new_tools | apps_discovered | Identical data — apps first seen in the period |
There are no unique fields on this endpoint. The generic replacement is a complete substitute.
Returns the count of AI applications first seen by this client during the reporting period. Use this endpoint to power the "New AI Tools" summary card on the dashboard.
An app is "first seen" if it has no usage records for this client before start_date.
For the paginated table of individual new tools, use New AI Tools.
For what qualifies as an "AI App", see AI Apps Overview.
Path Parameters
| Parameter | Type | Description |
|---|---|---|
client_id | string (uuid) | Unique identifier for the client organization |
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
granularity | string | Yes | - | Aggregation granularity: daily, weekly, monthly, quarterly |
start_date | string | Yes | - | Start of period (YYYY-MM-DD) |
end_date | string | Yes | - | End of period, inclusive (YYYY-MM-DD) |
compare_start_date | string | No | - | Comparison period start (YYYY-MM-DD). Must be provided with compare_end_date. |
compare_end_date | string | No | - | Comparison period end, inclusive (YYYY-MM-DD). Must be provided with compare_start_date. |
Comparison period
When both compare_start_date and compare_end_date are provided, total_new_tools.change_pct contains the percentage change from the comparison period to the primary period. When omitted, it is null.
Providing only one of the two comparison parameters returns 400.
Response
Returns an AiAppRecentSummary object.
Example Requests
Basic summary for February 2026
curl -X GET "https://api.example.com/v2/clients/aa7cf840-9ca9-46a3-9778-9015d6580d50/analytics/apps/ai/recent/summary?start_date=2026-02-01&end_date=2026-02-28" \
-H "Authorization: Bearer YOUR_API_TOKEN"
With month-over-month comparison
curl -X GET "https://api.example.com/v2/clients/aa7cf840-9ca9-46a3-9778-9015d6580d50/analytics/apps/ai/recent/summary?start_date=2026-02-01&end_date=2026-02-28&compare_start_date=2026-01-01&compare_end_date=2026-01-31" \
-H "Authorization: Bearer YOUR_API_TOKEN"
Example Responses
With comparison period
{
"total_new_tools": { "value": 4, "change_pct": 33.3, "compare_value": 3 }
}
Without comparison period
{
"total_new_tools": { "value": 4, "change_pct": null, "compare_value": null }
}
AiAppRecentSummary
| Field | Type | Nullable | Description |
|---|---|---|---|
total_new_tools | MetricWithDeltaDto | No | Number of AI apps first seen by this client during the period |
DB source:
| DTO Field | DB Aggregation |
|---|---|
total_new_tools.value | Count of distinct AI apps where MIN(activity_date) for this client falls within the period |
total_new_tools.change_pct | ((current - comparison) / comparison) * 100 using the same logic over the comparison date range |
total_new_tools.compare_value | The same aggregation as total_new_tools.value applied to the comparison date range. null when no comparison period is requested. |
Error Responses
| Status | Description |
|---|---|
| 400 | Invalid parameters (bad date format, range exceeds 366 days, mismatched comparison params) |
| 401 | Authentication required |
| 403 | Insufficient permissions for this client |
| 404 | Client not found |
| 500 | Server error |
Related Endpoints
- New AI Tools -- Paginated list of newly discovered AI apps
- AI App Users Summary -- Summary metrics for AI app user adoption
- AI Apps Overview -- Domain overview