---
title: "Update Evaluation"
method: PUT
path: "/api/evaluations/{eval_id}"
tags: ["Evaluations"]
---

# Update Evaluation

`PUT /api/evaluations/{eval_id}`

## Request

- Base URL: `https://api.thebetterhire.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.thebetterhire.ai/api/evaluations/{eval_id}`
- Auth: HTTP bearer

Partial update. competency_scores/evidence are json.dumps'd (JSONB);
strengths/weaknesses pass through as lists (TEXT[]).

## Path parameters

- `eval_id` string, uuid, required

## Request body

- EvaluationUpdate: PUT body. Field set mirrors the old route's whitelist exactly.
  - `overall_rating` integer, nullable
  - `competency_scores` unknown
  - `feedback_text` string, nullable
  - `strengths` string[], nullable
  - `weaknesses` string[], nullable
  - `recommendation` string, nullable
  - `evidence` unknown

## Response `200`

Successful Response

- EvaluationRow: Full evaluations row (SELECT * / RETURNING *). Every column declared so nothing silently drops when a column is added.
  - `id` string, required
  - `organization_id` string, required
  - `interview_id` string, required
  - `application_id` string, nullable
  - `interview_stage_id` string, nullable
  - `evaluator_type` string, nullable
  - `evaluator_user_id` string, nullable
  - `evaluator_name` string, nullable
  - `evaluator_model` string, nullable
  - `overall_rating` integer, nullable
  - `competency_scores` unknown
  - `feedback_text` string, nullable
  - `strengths` string[], nullable
  - `weaknesses` string[], nullable
  - `key_highlights` string[], nullable
  - `recommendation` string, nullable
  - `recommendation_reasoning` string, nullable
  - `evidence` unknown
  - `created_at` string, date-time, nullable
  - `updated_at` string, date-time, nullable
  - `deleted_at` string, date-time, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api.md) · [All operations](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/llms.txt) · [OpenAPI document](https://skmtc.dev/thebetterhire/apis/interanalysis-b2b-api/revisions/c8ad03e900ea?raw)