---
title: "Rate a documented endpoint"
method: POST
path: "/v1/rate"
tags: ["Feedback"]
---

# Rate a documented endpoint

`POST /v1/rate`

## Request

- Base URL: `https://app.taskfuel.ai`
- URL: `https://app.taskfuel.ai/v1/rate`
- Auth: HTTP bearer

Rate a catalog endpoint you called, using the method and url exactly as discover returns them: vote up if you got the expected/useful result, down if it didn't work or wasn't worth the price. Rate it against its own docs, from a call you made. Not down-votes: a missing catalog entry, your own bad arguments, or an endpoint that worked but wasn't what your task needed. Vote and report must agree. Add report to describe what concretely disrupted usage: an unexpected response code, ignored arguments, an empty or low-quality response (it doesn't change the rating). One vote per endpoint: voting again replaces the previous vote. Problems with taskfuel itself go to /v1/feedback instead.

## Request body

- RateRequest
  - `method` string, required
  - `url` string, uri, required
  - `vote` 'up' | 'down', required
  - `report` string

## Response `200`

Vote recorded.

- RateResult
  - `method` string, required
  - `url` string, uri, required
  - `vote` 'up' | 'down', required

## Other responses

- `400`: The rating body is invalid.
- `401`: The bearer API key is missing or invalid.
- `403`: This account has not made any paid call yet.
- `404`: No documented operation with that method and url.
- `413`: The rating body exceeds 16 KiB.
- `429`: More than 60 votes per minute.

---

[API](https://skmtc.dev/taskfuel/apis/taskfuel-gateway-api.md) · [All operations](https://skmtc.dev/taskfuel/apis/taskfuel-gateway-api/llms.txt) · [OpenAPI document](https://skmtc.dev/taskfuel/apis/taskfuel-gateway-api/revisions/fbf2d5210800?raw)