---
title: "Evaluate Thread"
method: POST
path: "/v1/evaluate/threads/{threadId}"
tags: ["Evaluation"]
---

# Evaluate Thread

`POST /v1/evaluate/threads/{threadId}`

Triggers evaluation of a thread using a specified metric collection and optional chatbot role instructions.

## Request body

- EvaluateThreadRequest
  - `metricCollection` string, required — This is the name of the multi-turn metric collection to evaluate the thread.
  - `chatbotRole` string — The role or purpose of the chatbot in the thread.

## Response `200`

- EvaluateThreadResponse
  - `success` boolean, required — This is true if the thread was successfully evaluated.
  - `data` object, required
    - `id` string — This is the id of the thread generated by Confident AI, not to be confused with the thread id you supplied.
  - `deprecated` boolean, required — This is true if this endpoint is deprecated.

---

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