> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Rate Voice

> Give a public library voice a 1-5 star rating.

## Overview

Records your rating (1-5) for a voice in the Bland library. Ratings are aggregated and surfaced as `average_rating` and `total_ratings` on each voice. Each caller can have at most one active rating per voice, sending a new rating overwrites the previous one. Send `DELETE` to the same path to clear your rating.

This call is throttled to 20 ratings per minute per org.

***

## Headers

**authorization** `string` *required*

Your API key for authentication.

***

## Path Parameters

**id** `string` *required*

UUID of the voice to rate.

***

## Body Parameters

**rating** `integer` *required*

Rating value, 1 to 5.

***

## Response

**status** `string`

`success` on success.

**total\_ratings** `number`

The voice's new total rating count.

**average\_rating** `number`

The voice's new average rating.

```json Response theme={null}
{
  "status": "success",
  "total_ratings": 8,
  "average_rating": 4.875
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.