# net.olamaelcu.livtet.biblio.review.create

> Create a community.lexicon.media.book.review record for the caller.

- Kind: procedure
- Authority: review.biblio.livtet.olamaelcu.net
- Lexicon: 1
- Published by [biblio.livtet.olamaelcu.net](https://lexicon.garden/identity/did:plc:e2x3ihw2ntxt7pcgzmtu3abi), the NSID's authority

## Links

- [Documentation](https://lexicon.garden/lexicon/did:plc:e2x3ihw2ntxt7pcgzmtu3abi/net.olamaelcu.livtet.biblio.review.create)
- [Schema JSON](https://lexicon.garden/lexicon/did:plc:e2x3ihw2ntxt7pcgzmtu3abi/net.olamaelcu.livtet.biblio.review.create/schema.json)
- [Analytics](https://lexicon.garden/lexicon/did:plc:e2x3ihw2ntxt7pcgzmtu3abi/net.olamaelcu.livtet.biblio.review.create/analytics)

## Procedure (`net.olamaelcu.livtet.biblio.review.create`)

Type: procedure · POST

### Input (application/json)

- `content` (union): Optional client-specific rich content; each object carries a $type.
  - One of: 
- `flags` (ref): Optional presentation flags.
  - Reference: `community.lexicon.media.book.review#flags`
- `rating` (integer): Rating on a 1-20 scale; divide by four for a five-star display.
  - Constraints: minimum: 1, maximum: 20
- `subject` (ref, required): Self-contained book reference the review is about.
  - Reference: `community.lexicon.media.book.defs#editionRef`
- `subjectRecord` (string · at-uri): Optional AT-URI of an edition record for enrichment.
- `textContent` (string): Plain-text review.
  - Constraints: minLength: 1

### Output (application/json)

- `uri` (string · at-uri, required): AT-URI of the new review record.

## Schema

```json
{
  "$type": "com.atproto.lexicon.schema",
  "defs": {
    "main": {
      "description": "Create a community.lexicon.media.book.review record for the caller.",
      "input": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "content": {
              "description": "Optional client-specific rich content; each object carries a $type.",
              "refs": [],
              "type": "union"
            },
            "flags": {
              "description": "Optional presentation flags.",
              "ref": "community.lexicon.media.book.review#flags",
              "type": "ref"
            },
            "rating": {
              "description": "Rating on a 1-20 scale; divide by four for a five-star display.",
              "maximum": 20,
              "minimum": 1,
              "type": "integer"
            },
            "subject": {
              "description": "Self-contained book reference the review is about.",
              "ref": "community.lexicon.media.book.defs#editionRef",
              "type": "ref"
            },
            "subjectRecord": {
              "description": "Optional AT-URI of an edition record for enrichment.",
              "format": "at-uri",
              "type": "string"
            },
            "textContent": {
              "description": "Plain-text review.",
              "minLength": 1,
              "type": "string"
            }
          },
          "required": [
            "subject"
          ],
          "type": "object"
        }
      },
      "output": {
        "encoding": "application/json",
        "schema": {
          "properties": {
            "uri": {
              "description": "AT-URI of the new review record.",
              "format": "at-uri",
              "type": "string"
            }
          },
          "required": [
            "uri"
          ],
          "type": "object"
        }
      },
      "type": "procedure"
    }
  },
  "description": "Create a review of an edition at a fresh TID rkey. Separate rkeys allow multiple reviews of the same book, including rereads.",
  "id": "net.olamaelcu.livtet.biblio.review.create",
  "lexicon": 1
}
```
