Analytics
Analytics and insights
14 endpoints
Get agent performance metrics
Returns performance metrics for agents. Also available at deprecated alias `/analytics/validators/performance`.
Parameters
projectstringqueryProject UUID or name
daysintegerqueryTime window in days
Default:30limitintegerqueryMaximum number of results
Default:50Responses
Response fields
dataobject[]/api/v1/analytics/agents/performancecurl -X GET "https://api.uluops.ai/api/v1/analytics/agents/performance" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": []
}Get agent reliability metrics
Returns reliability metrics for agents.
Parameters
agentstringqueryversionstringqueryFilter by agent definition version
projectstringqueryProject UUID or name
daysintegerqueryTime window in days
Default:30Responses
Response fields
dataobject/api/v1/analytics/agents/reliabilitycurl -X GET "https://api.uluops.ai/api/v1/analytics/agents/reliability" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": "..."
}Get project resolution rates
Parameters
projectstringqueryProject UUID or name
daysintegerqueryTime window in days
Default:30limitintegerqueryMaximum number of results
Default:50Responses
Response fields
dataobject[]/api/v1/analytics/projects/resolution-ratescurl -X GET "https://api.uluops.ai/api/v1/analytics/projects/resolution-rates" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": []
}Get file hotspots
Parameters
projectstringqueryProject UUID or name
daysintegerqueryTime window in days
Default:30limitintegerqueryMaximum number of results
Default:50Responses
Response fields
dataobject[]/api/v1/analytics/files/hotspotscurl -X GET "https://api.uluops.ai/api/v1/analytics/files/hotspots" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": [
{
"filePath": "...",
"issueCount": 0,
"severity": "..."
}
]
}Get taxonomy distribution
Parameters
projectstringqueryProject UUID or name
daysintegerqueryTime window in days
Default:30limitintegerqueryMaximum number of results
Default:50Responses
Response fields
dataobject/api/v1/analytics/taxonomy/distributioncurl -X GET "https://api.uluops.ai/api/v1/analytics/taxonomy/distribution" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": "..."
}Get full taxonomy analytics
Parameters
projectstringqueryProject UUID or name
daysintegerqueryTime window in days
Default:30limitintegerqueryMaximum number of results
Default:50Responses
Response fields
dataobject/api/v1/analytics/taxonomy/fullcurl -X GET "https://api.uluops.ai/api/v1/analytics/taxonomy/full" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": "..."
}Get taxonomy burndown
Parameters
projectstringqueryProject UUID or name
daysintegerqueryTime window in days
Default:30granularitystringquerydailyweeklydailyResponses
Response fields
dataobject/api/v1/analytics/taxonomy/burndowncurl -X GET "https://api.uluops.ai/api/v1/analytics/taxonomy/burndown" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": "..."
}Get taxonomy velocity metrics
Parameters
projectstringqueryProject UUID or name
daysintegerqueryTime window in days
Default:30alertThresholdnumberquery50Responses
Response fields
dataobject/api/v1/analytics/taxonomy/velocitycurl -X GET "https://api.uluops.ai/api/v1/analytics/taxonomy/velocity" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": "..."
}Get discovery timeline
Parameters
projectstringqueryProject UUID or name
daysintegerqueryTime window in days
Default:30groupBystringquerydayweekmonthdayResponses
Response fields
dataobject/api/v1/analytics/taxonomy/discoverycurl -X GET "https://api.uluops.ai/api/v1/analytics/taxonomy/discovery" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": "..."
}Get agent-taxonomy matrix
Returns agent-taxonomy coverage matrix. Also available at deprecated alias `/analytics/taxonomy/validator-matrix`.
Parameters
projectstringqueryProject UUID or name
daysintegerqueryTime window in days
Default:30minIssuesintegerquery5Responses
Response fields
dataobject/api/v1/analytics/taxonomy/agent-matrixcurl -X GET "https://api.uluops.ai/api/v1/analytics/taxonomy/agent-matrix" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": "..."
}Get trend summary
Parameters
projectstringqueryProject UUID or name
daysintegerqueryTime window in days
Default:30limitintegerqueryMaximum number of results
Default:50Responses
Response fields
dataobject/api/v1/analytics/trends/summarycurl -X GET "https://api.uluops.ai/api/v1/analytics/trends/summary" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": "..."
}Get analytics by metric name (catch-all)
Generic analytics endpoint that accepts a metric name as a path parameter. Supported metrics: `agent_performance`, `resolution_rates`, `cross_project_patterns`, `file_hotspots`, `regression_analysis`, `trend_summary`, `cost_analysis`, `taxonomy_distribution`. **Note** (live-tests T2 §3.2, F8): `cross_project_patterns` is not yet implemented and always returns `[]`. Treat `[]` as "metric placeholder", NOT as "no patterns in your data." A real element shape and optional `insufficientData` signal will be added when cross-project pattern aggregation ships.
Parameters
metricrequiredstringpathagent_performanceresolution_ratescross_project_patternsfile_hotspotsregression_analysistrend_summarycost_analysistaxonomy_distributionprojectstringqueryProject UUID or name
daysintegerqueryTime window in days
Default:30limitintegerqueryMaximum number of results
Default:50Responses
Response fields
dataobject/api/v1/analytics/{metric}curl -X GET "https://api.uluops.ai/api/v1/analytics/agent_performance" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": "..."
}Get runs by definition identity
Cross-project query returning validation runs matching a definition identity (type + name + optional version). Used by the Registry API analytics extension for cross-service correlation.
Parameters
typerequiredstringqueryagentcommandworkflowpipelinenamerequiredstringqueryversionstringquerydefinitionIdstringuuidqueryRegistry definition UUID for precise matching
periodstringquery30dlimitintegerqueryMaximum number of results (1–1000)
Default:100offsetintegerqueryNumber of results to skip
Default:0Responses
Response fields
dataobject/api/v1/analytics/definitions/by-definitioncurl -X GET "https://api.uluops.ai/api/v1/analytics/definitions/by-definition?type=agent&name=my-project" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": {
"runs": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"projectId": "550e8400-e29b-41d4-a716-446655440000",
"runNumber": 0,
"workflowType": "...",
"timestamp": "2026-01-15T10:30:00Z",
"allGatesPassed": true,
"averageScore": 0,
"rawMarkdown": "...",
"archivedAt": "2026-01-15T10:30:00Z",
"archiveReason": "...",
"idempotencyKey": "...",
"payloadHash": "...",
"definitionType": "...",
"definitionName": "...",
"definitionVersion": "...",
"definitionHash": "...",
"definitionId": "550e8400-e29b-41d4-a716-446655440000",
"registrySyncedAt": "2026-01-15T10:30:00Z",
"mergedFromProjectId": "550e8400-e29b-41d4-a716-446655440000",
"mergedFromRunNumber": 0,
"mergedFromIdempotencyKey": "...",
"authorId": "550e8400-e29b-41d4-a716-446655440000",
"projectSlug": "...",
"orgSlug": "...",
"createdAt": "2026-01-15T10:30:00Z",
"updatedAt": "2026-01-15T10:30:00Z"
}
],
"total": 0,
"limit": 0,
"offset": 0
}
}Get pre-aggregated definition summary
Returns pre-aggregated metrics for a definition including run count, average score, pass rate, and unique project count. Used by the Registry API analytics extension.
Parameters
typerequiredstringpathagentcommandworkflowpipelinenamerequiredstringpathversionstringqueryperiodstringquery30dResponses
Response fields
dataobject/api/v1/analytics/definitions/{type}/{name}/summarycurl -X GET "https://api.uluops.ai/api/v1/analytics/definitions/agent/my-project/summary" \
-H "Authorization: Bearer $ULUOPS_TOKEN"{
"data": {
"definitionType": "...",
"definitionName": "...",
"definitionVersion": "...",
"period": "...",
"runCount": 0,
"avgScore": 0,
"passRate": 0,
"uniqueProjects": 0
}
}