Garchi CMS Reviews API

openapi: 3.2.0
info:
  title: Garchi CMS Reviews API
  version: '2026-11-09'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-09: 39 operation(s) read from 6 public documentation page(s) (each operation names its page in x-source). This is not the provider''s published contract; Garchi CMS has published no machine-readable contract that the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 39
    documentation: 0
    pages-with-code: 5
    pages-read: 6
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-09'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://garchi.co.uk/docs/v2
  - https://garchi.co.uk/install
  - https://garchi.co.uk/documentation/1.0/headlessweb/section-template
  - https://garchi.co.uk/documentation/1.0/headlessweb/page
  - https://garchi.co.uk/documentation/1.0/usage/next-pages-router
  - https://garchi.co.uk/documentation/1.0/usage/next-app-router
security:
- bearer: []
tags:
- name: Reviews
paths:
  /api/v2/reviews/delete:
    post:
      operationId: post_api_v2_reviews_delete
      tags:
      - Reviews
      summary: POST /api/v2/reviews/delete
      x-source: https://garchi.co.uk/docs/v2
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV2ReviewsDeleteResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --request POST  \"https://garchi.co.uk/api/v2/reviews/delete\"  --header \"Authorization: Bearer {YOUR_API_TOKEN}\"  --header \"Content-Type: application/json\"  --data \"{\n \\\"review_id\\\": 2\n}\""
  /api/v2/reviews/edit:
    post:
      operationId: post_api_v2_reviews_edit
      tags:
      - Reviews
      summary: POST /api/v2/reviews/edit
      x-source: https://garchi.co.uk/docs/v2
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV2ReviewsEditResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --request POST  \"https://garchi.co.uk/api/v2/reviews/edit\"  --header \"Authorization: Bearer {YOUR_API_TOKEN}\"  --header \"Content-Type: application/json\"  --data \"{\n \\\"review_id\\\": 4,\n \\\"review_body\\\": \\\"This is an amazing seller.\\\",\n \\\"rating\\\": 4\n}\""
  /api/v2/reviews/item:
    post:
      operationId: post_api_v2_reviews_item
      tags:
      - Reviews
      summary: POST /api/v2/reviews/item
      x-source: https://garchi.co.uk/docs/v2
      responses:
        '201':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV2ReviewsItemResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: "curl --request POST  \"https://garchi.co.uk/api/v2/reviews/item\"  --header \"Authorization: Bearer {YOUR_API_TOKEN}\"  --header \"Content-Type: application/json\"  --data \"{\n \\\"item_id\\\": 4,\n \\\"rating\\\": 4,\n \\\"review_body\\\": \\\"This is a best selling item.\\\",\n \\\"user_email\\\": \\\"jane.doe@example.com\\\",\n \\\"user_name\\\": \\\"Jane\\\",\n \\\"parent_id\\\": 4\n}\""
  /api/v2/reviews/item/{itemid}:
    get:
      operationId: get_api_v2_reviews_item_itemid
      tags:
      - Reviews
      summary: GET /api/v2/reviews/item/{itemId}
      x-source: https://garchi.co.uk/docs/v2
      parameters:
      - name: itemid
        in: path
        required: true
        schema:
          type: string
      - name: size
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (shape read from the example response on the page)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV2ReviewsItemItemidResponse'
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl --request GET  --get "https://garchi.co.uk/api/v2/reviews/item/15?size=10"  --header "Authorization: Bearer {YOUR_API_TOKEN}" '
components:
  schemas:
    GetApiV2ReviewsItemItemidResponse:
      type: object
      properties:
        size:
          type: integer
    PostApiV2ReviewsEditResponse:
      type: object
      properties:
        review_id:
          type: integer
        review_body:
          type: string
        rating:
          type: integer
    PostApiV2ReviewsDeleteResponse:
      type: object
      properties:
        message:
          type: string
    PostApiV2ReviewsItemResponse:
      type: object
      properties:
        item_id:
          type: integer
        rating:
          type: integer
        review_body:
          type: string
        user_email:
          type: string
        user_name:
          type: string
        parent_id:
          type: integer
  securitySchemes:
    bearer:
      type: http
      scheme: bearer