v51

OpenAPI 3.1.0Apache 2.0raw.githubusercontent.com2026-08-01308532588.1 KB

Manual Evaluation

Manually evaluate traces

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

post/v1/private/manual-evaluation/traces

Request body

project_idstring uuid required

Project ID

entity_idsstring[] required

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

rule_idsstring[] required

List of automation rule IDs to apply

entity_type'trace' | 'thread' | 'span' required

Type of entity to evaluate (trace or thread)

Example request

{
  "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"
}

Response

Accepted - Evaluation request queued successfully

entities_queuedinteger

Number of entities queued for evaluation

rules_appliedinteger

Number of rules that will be applied

Example response

{
  "entities_queued": 5,
  "rules_applied": 2
}