Analysis
Structured analysis data from agent runs
4 endpoints
Get analysis data for a run
Returns all analysis records and summaries for a specific run.
Requires authentication
Parameters
idrequiredstringuuidpathRun UUID
Responses
200Analysis records and summaries for the run
401Missing or invalid authentication
404Resource not found
Response fields
dataobjectGET
/api/v1/runs/{id}/analysiscurl -X GET "https://api.uluops.ai/api/v1/runs/550e8400-e29b-41d4-a716-446655440000/analysis" \
-H "Authorization: Bearer $ULUOPS_TOKEN"Response
{
"data": {
"records": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"runId": "550e8400-e29b-41d4-a716-446655440000",
"agentName": "...",
"agentType": "validator",
"recordType": "...",
"recordId": "...",
"title": "...",
"classification": "...",
"severity": "critical",
"recordData": "...",
"createdAt": "2026-01-15T10:30:00Z"
}
],
"summaries": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"runId": "550e8400-e29b-41d4-a716-446655440000",
"agentName": "...",
"agentType": "validator",
"decision": "...",
"score": 0,
"decisionVocabulary": "...",
"systemMetrics": "...",
"categoryScores": [
{
"name": "...",
"weight": 0,
"score": 0
}
],
"epistemicAssessment": "...",
"auditImplications": [],
"createdAt": "2026-01-15T10:30:00Z"
}
],
"total": 0
}
}Get analysis summaries for a project
Returns analysis summaries for a project over time. Accepts project UUID or name.
Requires authentication
Parameters
idrequiredstringpathProject UUID or name
agentNamestringqueryFilter by agent name
agentTypestringqueryFilter by agent type
validatoranalystexplorerforecasterexecutorgeneratordecisionstringqueryFilter by decision outcome
limitintegerqueryMaximum number of results
Default:50offsetintegerqueryNumber of results to skip
Default:0Responses
200Paginated analysis summaries for the project
401Missing or invalid authentication
404Resource not found
Response fields
dataAnalysisSummary[]totalintegerlimitintegeroffsetintegerGET
/api/v1/projects/{id}/analysiscurl -X GET "https://api.uluops.ai/api/v1/projects/550e8400-e29b-41d4-a716-446655440000/analysis" \
-H "Authorization: Bearer $ULUOPS_TOKEN"Response
{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"runId": "550e8400-e29b-41d4-a716-446655440000",
"agentName": "...",
"agentType": "validator",
"decision": "...",
"score": 0,
"decisionVocabulary": "...",
"systemMetrics": "...",
"categoryScores": [
{
"name": "...",
"weight": 0,
"score": 0
}
],
"epistemicAssessment": "...",
"auditImplications": [],
"createdAt": "2026-01-15T10:30:00Z"
}
],
"total": 0,
"limit": 0,
"offset": 0
}Query analysis records across projects
Cross-project query for analysis records with filters. Scoped to authenticated user's projects.
Requires authentication
Parameters
recordTypestringqueryFilter by record type
classificationstringqueryFilter by classification
agentNamestringqueryFilter by agent name
agentTypestringqueryFilter by agent type
validatoranalystexplorerforecasterexecutorgeneratorseveritystringqueryFilter by severity
criticalhighmediumlowinfolimitintegerqueryMaximum number of results
Default:50offsetintegerqueryNumber of results to skip
Default:0Responses
200Paginated analysis records
401Missing or invalid authentication
Response fields
dataAnalysisRecord[]totalintegerlimitintegeroffsetintegerGET
/api/v1/analysis/recordscurl -X GET "https://api.uluops.ai/api/v1/analysis/records" \
-H "Authorization: Bearer $ULUOPS_TOKEN"Response
{
"data": [
{
"id": "550e8400-e29b-41d4-a716-446655440000",
"runId": "550e8400-e29b-41d4-a716-446655440000",
"agentName": "...",
"agentType": "validator",
"recordType": "...",
"recordId": "...",
"title": "...",
"classification": "...",
"severity": "critical",
"recordData": "...",
"createdAt": "2026-01-15T10:30:00Z"
}
],
"total": 0,
"limit": 0,
"offset": 0
}Get agent runs analysis
Requires authentication
Parameters
namerequiredstringpathAgent name
Responses
200Analysis summaries with run context for the agent
401Missing or invalid authentication
Response fields
dataobjectGET
/api/v1/agents/{name}/runs-analysiscurl -X GET "https://api.uluops.ai/api/v1/agents/my-project/runs-analysis" \
-H "Authorization: Bearer $ULUOPS_TOKEN"Response
{
"data": "..."
}