---
title: "Submit Human Rating"
method: POST
path: "/api/v1/calibration/runs/{run_id}/ratings"
tags: ["calibration"]
---

# Submit Human Rating

`POST /api/v1/calibration/runs/{run_id}/ratings`

## Request

- Base URL: `https://geo.sig.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://geo.sig.ai/api/v1/calibration/runs/{run_id}/ratings`
- Auth: HTTP bearer

Submit a human rating for a query execution.

Args:
    run_id: Calibration run UUID
    request: Rating data
    current_user: Authenticated user (becomes rater)
    db: Database session

Returns:
    Created human rating

Raises:
    HTTPException: If run not found or access denied

## Path parameters

- `run_id` string, uuid, required

## Cookies

- `access_token` string, nullable

## Request body

- SubmitRatingRequest: Request to submit a human rating.
  - `query_execution_id` string, uuid, required
  - `brand_id` string, uuid, required
  - `mentioned` boolean, nullable
  - `explicit_rank` integer, nullable
  - `implicit_rank` integer, nullable
  - `reasoning` string, nullable
  - `recommendation_strength` number, nullable
  - `recommendation_type` string, nullable
  - `is_conditional` boolean, nullable
  - `condition` string, nullable
  - `stance` string, nullable
  - `sentiment_score` number, nullable
  - `positive_aspects` string[]
  - `negative_aspects` string[]
  - `risk_flags` object
  - `confidence` number, nullable
  - `time_spent_seconds` integer, nullable
  - `notes` string, nullable

## Response `201`

Successful Response

- HumanRatingResponse: Response for human rating details.
  - `id` string, uuid, required
  - `calibration_run_id` string, uuid, required
  - `query_execution_id` string, uuid, required
  - `brand_id` string, uuid, required
  - `rater_id` string, uuid, nullable, required
  - `rater_email` string, required
  - `mentioned` boolean, nullable, required
  - `recommendation_strength` number, nullable, required
  - `stance` string, nullable, required
  - `confidence` number, nullable, required
  - `created_at` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api.md) · [All operations](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sig/apis/ai-visibility-intelligence-api/revisions/3ec39f9be9e0?raw)