Manually evaluate threads | Opik Documentation

Manually trigger evaluation rules on selected threads. Bypasses sampling and enqueues all specified threads for evaluation.

This endpoint expects an object.

project_idstringRequiredformat: "uuid"

Project ID

entity_idslist of stringsRequired

List of entity IDs (trace IDs or thread IDs) to evaluate

rule_idslist of stringsRequired

List of automation rule IDs to apply

entity_typeenumRequired

Type of entity to evaluate (trace or thread)

Allowed values:

Accepted - Evaluation request queued successfully

entities_queuedinteger or null

Number of entities queued for evaluation

rules_appliedinteger or null

Number of rules that will be applied

1	import requests
2
3	url = "http://localhost:5173/api/v1/private/manual-evaluation/threads"
4
5	payload = {
6	"project_id": "550e8400-e29b-41d4-a716-446655440000",
7	"entity_ids": ["550e8400-e29b-41d4-a716-446655440000", "550e8400-e29b-41d4-a716-446655440001"],
8	"rule_ids": ["660e8400-e29b-41d4-a716-446655440000"],
9	"entity_type": "trace"
10	}
11	headers = {"Content-Type": "application/json"}
12
13	response = requests.post(url, json=payload, headers=headers)
14
15	print(response.json())