For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Copy to LLMGithubGo to App
DocumentationIntegrationsBuilding Self-Improving AgentsSelf-hosting OpikSDK & API reference
DocumentationIntegrationsBuilding Self-Improving AgentsSelf-hosting OpikSDK & API reference
    • Overview
  • Python SDK
    • Reference
    • REST API Client
  • Typescript SDK
    • Overview
    • Opik TS
    • Prompts
    • Opik Query Language (OQL)
  • Rest API
    • Overview
        • POSTManually evaluate spans
        • POSTManually evaluate threads
        • POSTManually evaluate traces
LogoLogo
Copy to LLMGithubGo to App
Rest APIAPI ReferenceManual Evaluation

Manually evaluate spans

POST
/v1/private/manual-evaluation/spans
POST
/api/v1/private/manual-evaluation/spans
$curl -X POST http://localhost:5173/api/v1/private/manual-evaluation/spans \
>     -H "Content-Type: application/json" \
>     -d '{
>  "project_id": "550e8400-e29b-41d4-a716-446655440000",
>  "entity_ids": [
>    "550e8400-e29b-41d4-a716-446655440000",
>    "550e8400-e29b-41d4-a716-446655440001"
>  ],
>  "rule_ids": [
>    "660e8400-e29b-41d4-a716-446655440000"
>  ],
>  "entity_type": "trace"
>}'
1{
2  "entities_queued": 5,
3  "rules_applied": 2
4}
Manually trigger evaluation rules on selected spans. Bypasses sampling and enqueues all specified spans for evaluation.
Was this page helpful?
Previous

Manually evaluate threads

Next
Built with

Request

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:

Response

Accepted - Evaluation request queued successfully

entities_queuedinteger
Number of entities queued for evaluation
rules_appliedinteger
Number of rules that will be applied

Errors

400
Bad Request Error
404
Not Found Error