Skip to main content
GET
/
v2
/
failure-analysis
/
runs
/
{run_id}
/
tags
Get failure tags
curl --request GET \
  --url https://api.valiqor.com/v2/failure-analysis/runs/{run_id}/tags \
  --header 'Authorization: Bearer <token>'
[
  {
    "tag_id": "<string>",
    "bucket_id": "<string>",
    "bucket_name": "<string>",
    "subcategory_id": "<string>",
    "subcategory_name": "<string>",
    "decision": "<string>",
    "severity": 2.5,
    "confidence": 0.5,
    "detector_type_used": "<string>",
    "scoring_breakdown": {
      "impact": 123,
      "risk": 123,
      "final_severity": 123,
      "final_confidence": 123,
      "frequency_weight": 1,
      "security_override": "<string>",
      "deterministic_weight": 0,
      "judge_weight": 0,
      "security_weight": 0,
      "metric_agreement_bonus": 0,
      "disagreement_penalty": 0
    },
    "item_index": 123,
    "judge_rationale": "<string>",
    "eval_metric_values": {},
    "evidence_items": [
      {
        "item_id": "<string>",
        "evidence_type": "<string>",
        "description": "<string>",
        "source": "<string>",
        "content_snippet": "<string>",
        "confidence": 1,
        "metadata": {}
      }
    ]
  }
]

Authorizations

Authorization
string
header
required

Valiqor API key. Pass as Bearer token: Authorization: Bearer vq-xxxxxxxxxxxxxxxxxxxx

Path Parameters

run_id
string
required

Query Parameters

decision
string | null

Filter by decision: pass, fail, unsure

bucket_id
string | null

Filter by bucket ID

Response

Successful Response

tag_id
string
required
bucket_id
string
required

Parent bucket ID (L1 category)

bucket_name
string
required

Human-readable bucket name

subcategory_id
string
required

Failure subcategory ID (L2 category)

subcategory_name
string
required

Human-readable subcategory name

decision
string
required

'pass', 'fail', or 'unsure'

severity
number
required

Severity score 0-5

Required range: 0 <= x <= 5
confidence
number
required

Confidence score 0-1

Required range: 0 <= x <= 1
detector_type_used
string
required

'deterministic', 'llm_judge', or 'hybrid'

scoring_breakdown
ScoringBreakdownResponse · object
required

Scoring breakdown for a failure tag.

item_index
integer | null

0-based index of the dataset item this tag belongs to

judge_rationale
string | null

LLM judge explanation

eval_metric_values
Eval Metric Values · object

Correlated eval metric scores

evidence_items
EvidenceItemResponse · object[]