---
title: "Feedback"
description: "POST /api/v1/router/feedback — tell the router how its pick performed so model rankings improve."
canonical_url: "https://scholarxiv.com/developers/docs/router-api/feedback"
markdown_url: "https://scholarxiv.com/developers/docs/router-api/feedback.md"
---

> For the complete documentation index, see [llms.txt](/llms.txt).

# Feedback
URL: /developers/docs/router-api/feedback
LLM index: /llms.txt
Description: POST /api/v1/router/feedback — tell the router how its pick performed so model rankings improve.
Related: router-api/route, router-api/completions

# Feedback

```http
POST /api/v1/router/feedback
```

The router ships with estimated model rankings. Feedback is what replaces those
estimates with measurements — for your traffic, not a benchmark's.

## Request body

| Field | Type | Required | Description |
|---|---|---|---|
| `decision_id` | string | Yes | From a routing decision or a completions response. |
| `feedback` | string | Yes | `positive`, `negative`, `regenerated`, or `model_switched`. |

## What each value means

| Value | Send it when |
|---|---|
| `positive` | The answer was good. |
| `negative` | The answer was wrong, unusable, or off-target. |
| `regenerated` | The user asked for another attempt — the strongest implicit negative. |
| `model_switched` | The user overrode the routed model with their own choice. |

```bash title="feedback.sh"
curl -X POST https://scholarxiv.com/api/v1/router/feedback \
  -H "x-api-key: sxv_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "decision_id": "8f2c…", "feedback": "regenerated" }'
```

## Errors

| Status | Meaning |
|---|---|
| `400` | Missing `decision_id`, or `feedback` isn't one of the four values. |
| `404` | Unknown `decision_id`, or it belongs to another account. |

You can only score your own decisions — otherwise anyone holding a decision id could
skew someone else's routing.

## Sitemap

See the full [sitemap](/sitemap.md) for all pages.
Docs-scoped sitemap: [/docs/sitemap.md](/docs/sitemap.md).
Well-known sitemap: [/.well-known/sitemap.md](/.well-known/sitemap.md).