---
title: "Execute agent-flow-quality evaluator"
method: POST
path: "/v2/evaluators/execute/agent-flow-quality"
tags: ["evaluators"]
---

# Execute agent-flow-quality evaluator

`POST /v2/evaluators/execute/agent-flow-quality`

Validate agent trajectory against user-defined conditions

**Request Body:**
- `input.trajectory_prompts` (string, required): JSON array of prompts in the agent trajectory
- `input.trajectory_completions` (string, required): JSON array of completions in the agent trajectory
- `config.conditions` (array of strings, required): Array of evaluation conditions/rules to validate against
- `config.threshold` (number, required): Score threshold for pass/fail determination (0.0-1.0)

## Request body

- RequestAgentFlowQualityRequest
  - `config` RequestAgentFlowQualityConfigRequest, required
    - `conditions` string[], required
    - `threshold` number, required
  - `input` RequestAgentFlowQualityInput, required
    - `trajectory_completions` string, required
    - `trajectory_prompts` string, required

## Response `200`

OK

- ResponseAgentFlowQualityResponse
  - `reason` string
  - `score` number
  - `success` boolean

## Other responses

- `400` — Bad Request
- `500` — Internal Server Error

## Changes

- **2026-02-26** `ed3a7440b9d0` — 1 warning, 1 info
  - removed the optional property `result` from the response with the `200` status
  - added the optional property `success` to the response with the `200` status
- **2026-01-04** `ba3b59160a46` — 1 breaking
  - the request property `config` became required
- **2026-01-01** `aef6c851927f` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/traceloop/apis/traceloop-api/changes/v2/evaluators/execute/agent-flow-quality/post.md)

---

[API](https://skmtc.dev/traceloop/apis/traceloop-api.md) · [All operations](https://skmtc.dev/traceloop/apis/traceloop-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/traceloop/traceloop-api/revisions/c32c822f1929/schema)