Registry↗Dashboard↗

Analytics

Analytics and insights

14 endpoints

Get agent performance metrics

Returns performance metrics for agents. Also available at deprecated alias `/analytics/validators/performance`.

Requires authentication
projectstringquery

Project UUID or name

daysintegerquery

Time window in days

Default: 30
limitintegerquery

Maximum number of results

Default: 50
200Agent performance data
401Missing or invalid authentication
429Rate limit exceeded

Response fields

dataobject[]
GET/api/v1/analytics/agents/performance
curl -X GET "https://api.uluops.ai/api/v1/analytics/agents/performance" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": []
}

Get agent reliability metrics

Returns reliability metrics for agents.

Requires authentication
agentstringquery
versionstringquery

Filter by agent definition version

projectstringquery

Project UUID or name

daysintegerquery

Time window in days

Default: 30
200Agent reliability data
401Missing or invalid authentication
429Rate limit exceeded

Response fields

dataobject
GET/api/v1/analytics/agents/reliability
curl -X GET "https://api.uluops.ai/api/v1/analytics/agents/reliability" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": "..."
}

Get project resolution rates

Requires authentication
projectstringquery

Project UUID or name

daysintegerquery

Time window in days

Default: 30
limitintegerquery

Maximum number of results

Default: 50
200Resolution rate data
401Missing or invalid authentication
429Rate limit exceeded

Response fields

dataobject[]
GET/api/v1/analytics/projects/resolution-rates
curl -X GET "https://api.uluops.ai/api/v1/analytics/projects/resolution-rates" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": []
}

Get file hotspots

Requires authentication
projectstringquery

Project UUID or name

daysintegerquery

Time window in days

Default: 30
limitintegerquery

Maximum number of results

Default: 50
200File hotspot data
401Missing or invalid authentication
429Rate limit exceeded

Response fields

dataobject[]
GET/api/v1/analytics/files/hotspots
curl -X GET "https://api.uluops.ai/api/v1/analytics/files/hotspots" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": [
    {
      "filePath": "...",
      "issueCount": 0,
      "severity": "..."
    }
  ]
}

Get taxonomy distribution

Requires authentication
projectstringquery

Project UUID or name

daysintegerquery

Time window in days

Default: 30
limitintegerquery

Maximum number of results

Default: 50
200Taxonomy distribution data
401Missing or invalid authentication
429Rate limit exceeded

Response fields

dataobject
GET/api/v1/analytics/taxonomy/distribution
curl -X GET "https://api.uluops.ai/api/v1/analytics/taxonomy/distribution" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": "..."
}

Get full taxonomy analytics

Requires authentication
projectstringquery

Project UUID or name

daysintegerquery

Time window in days

Default: 30
limitintegerquery

Maximum number of results

Default: 50
200Full taxonomy analytics
401Missing or invalid authentication
429Rate limit exceeded

Response fields

dataobject
GET/api/v1/analytics/taxonomy/full
curl -X GET "https://api.uluops.ai/api/v1/analytics/taxonomy/full" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": "..."
}

Get taxonomy burndown

Requires authentication
projectstringquery

Project UUID or name

daysintegerquery

Time window in days

Default: 30
granularitystringquery
dailyweekly
Default: daily
200Taxonomy burndown data
401Missing or invalid authentication
429Rate limit exceeded

Response fields

dataobject
GET/api/v1/analytics/taxonomy/burndown
curl -X GET "https://api.uluops.ai/api/v1/analytics/taxonomy/burndown" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": "..."
}

Get taxonomy velocity metrics

Requires authentication
projectstringquery

Project UUID or name

daysintegerquery

Time window in days

Default: 30
alertThresholdnumberquery
Default: 50
200Taxonomy velocity data
401Missing or invalid authentication
429Rate limit exceeded

Response fields

dataobject
GET/api/v1/analytics/taxonomy/velocity
curl -X GET "https://api.uluops.ai/api/v1/analytics/taxonomy/velocity" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": "..."
}

Get discovery timeline

Requires authentication
projectstringquery

Project UUID or name

daysintegerquery

Time window in days

Default: 30
groupBystringquery
dayweekmonth
Default: day
200Discovery timeline data
401Missing or invalid authentication
429Rate limit exceeded

Response fields

dataobject
GET/api/v1/analytics/taxonomy/discovery
curl -X GET "https://api.uluops.ai/api/v1/analytics/taxonomy/discovery" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": "..."
}

Get agent-taxonomy matrix

Returns agent-taxonomy coverage matrix. Also available at deprecated alias `/analytics/taxonomy/validator-matrix`.

Requires authentication
projectstringquery

Project UUID or name

daysintegerquery

Time window in days

Default: 30
minIssuesintegerquery
Default: 5
200Agent-taxonomy matrix
401Missing or invalid authentication
429Rate limit exceeded

Response fields

dataobject
GET/api/v1/analytics/taxonomy/agent-matrix
curl -X GET "https://api.uluops.ai/api/v1/analytics/taxonomy/agent-matrix" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": "..."
}

Get trend summary

Requires authentication
projectstringquery

Project UUID or name

daysintegerquery

Time window in days

Default: 30
limitintegerquery

Maximum number of results

Default: 50
200Trend summary
401Missing or invalid authentication
429Rate limit exceeded

Response fields

dataobject
GET/api/v1/analytics/trends/summary
curl -X GET "https://api.uluops.ai/api/v1/analytics/trends/summary" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "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.

Requires authentication
metricrequiredstringpath
agent_performanceresolution_ratescross_project_patternsfile_hotspotsregression_analysistrend_summarycost_analysistaxonomy_distribution
projectstringquery

Project UUID or name

daysintegerquery

Time window in days

Default: 30
limitintegerquery

Maximum number of results

Default: 50
200Analytics data for the requested metric
400Invalid metric name
401Missing or invalid authentication
429Rate limit exceeded

Response fields

dataobject
GET/api/v1/analytics/{metric}
curl -X GET "https://api.uluops.ai/api/v1/analytics/agent_performance" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "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.

Requires authentication
typerequiredstringquery
agentcommandworkflowpipeline
namerequiredstringquery
versionstringquery
definitionIdstringuuidquery

Registry definition UUID for precise matching

periodstringquery
Default: 30d
limitintegerquery

Maximum number of results (1–1000)

Default: 100
offsetintegerquery

Number of results to skip

Default: 0
200Runs matching the definition identity
400Invalid or missing type/name parameter
401Missing or invalid authentication
429Rate limit exceeded

Response fields

dataobject
GET/api/v1/analytics/definitions/by-definition
curl -X GET "https://api.uluops.ai/api/v1/analytics/definitions/by-definition?type=agent&name=my-project" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "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.

Requires authentication
typerequiredstringpath
agentcommandworkflowpipeline
namerequiredstringpath
versionstringquery
periodstringquery
Default: 30d
200Aggregated definition metrics
400Invalid type parameter
401Missing or invalid authentication
422No runs found for this definition
429Rate limit exceeded

Response fields

dataobject
GET/api/v1/analytics/definitions/{type}/{name}/summary
curl -X GET "https://api.uluops.ai/api/v1/analytics/definitions/agent/my-project/summary" \
  -H "Authorization: Bearer $ULUOPS_TOKEN"
Response
{
  "data": {
    "definitionType": "...",
    "definitionName": "...",
    "definitionVersion": "...",
    "period": "...",
    "runCount": 0,
    "avgScore": 0,
    "passRate": 0,
    "uniqueProjects": 0
  }
}