# net.olamaelcu.livtet.biblio.bookReview

> A user's review of a book. StrongRefs the catalog book and optionally the originating bookShelving. rkey: tid. Written by the OAuth client (livtet-service) via com.atproto.repo.putRecord.

- Kind: record
- Record key: tid
- Authority: biblio.livtet.olamaelcu.net
- Lexicon: 1
- Published by [biblio.livtet.olamaelcu.net](https://lexicon.garden/identity/did:web:biblio.livtet.olamaelcu.net), the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:web:biblio.livtet.olamaelcu.net/net.olamaelcu.livtet.biblio.bookReview)
- [Schema JSON](https://lexicon.garden/lexicon/did:web:biblio.livtet.olamaelcu.net/net.olamaelcu.livtet.biblio.bookReview/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:web:biblio.livtet.olamaelcu.net/net.olamaelcu.livtet.biblio.bookReview/analytics)

## Record (`net.olamaelcu.livtet.biblio.bookReview`)

Type: record · key tid

### Properties

- `book` (string · at-uri, required): AT-URI of the catalog book record being reviewed.
- `createdAt` (string · datetime, required)
- `rating` (integer): Optional 1-10 rating. Half-stars are not yet supported at the lexicon level; round to the nearest integer. Tracked separately as a writer-side concern (see BookReviewRating type in livtet-service).
  - Constraints: minimum: 1, maximum: 10
- `shelf` (string · at-uri): AT-URI of the originating bookShelving record, if any.
- `text` (string, required): Free-form review body.

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "key": "tid",
      "record": {
        "properties": {
          "book": {
            "description": "AT-URI of the catalog book record being reviewed.",
            "format": "at-uri",
            "type": "string"
          },
          "createdAt": {
            "format": "datetime",
            "type": "string"
          },
          "rating": {
            "description": "Optional 1-10 rating. Half-stars are not yet supported at the lexicon level; round to the nearest integer. Tracked separately as a writer-side concern (see BookReviewRating type in livtet-service).",
            "maximum": 10,
            "minimum": 1,
            "type": "integer"
          },
          "shelf": {
            "description": "AT-URI of the originating bookShelving record, if any.",
            "format": "at-uri",
            "type": "string"
          },
          "text": {
            "description": "Free-form review body.",
            "type": "string"
          }
        },
        "required": [
          "text",
          "book",
          "createdAt"
        ],
        "type": "object"
      },
      "type": "record"
    }
  },
  "description": "A user's review of a book. StrongRefs the catalog book and optionally the originating bookShelving. rkey: tid. Written by the OAuth client (livtet-service) via com.atproto.repo.putRecord.",
  "id": "net.olamaelcu.livtet.biblio.bookReview",
  "lexicon": 1
}
```