---
title: "Rate"
method: POST
path: "/v1/jobs/{job_id}/rating"
tags: ["jobs"]
---

# Rate

`POST /v1/jobs/{job_id}/rating`

## Request

- Base URL: `https://api.mocapless.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.mocapless.com/v1/jobs/{job_id}/rating`
- Auth: none declared

Thumbs up or down on a finished clip, or 1 to 5 stars with what was
wrong, with an optional note. Score 0 clears it. This is the product's
ground truth for what "good" means, and a low one opens a case
(services.ratings) that is worked on until the clip is fixed.

## Path parameters

- `job_id` string, required

## Headers

- `authorization` string, nullable
- `X-API-Key` string, nullable

## Request body

- RatingRequest
  - `score` integer, nullable
  - `stars` integer, nullable
  - `reasons` string[], nullable
  - `note` string, nullable

## Response `200`

Successful Response

- JobResponse
  - `id` string, required
  - `status` string, required
  - `stage` string, required
  - `progress` number, required
  - `prompt` string, required
  - `error` string, nullable, required
  - `creditsCost` integer, required
  - `creditsRefunded` boolean, required
  - `frames` integer, required
  - `durationSeconds` number, required
  - `assetId` string, nullable, required
  - `createdAt` string, date-time, required
  - `finishedAt` string, date-time, nullable, required
  - `script` ScriptModel
    - `segments` SegmentModel[], required
      - `primitive` string, required
      - `seconds` number
      - `speed` number
      - `amplitude` number
      - `style` string
      - `repeats` integer
      - `mirror` boolean
      - `turn` number
      - `params` object
    - `fps` integer
    - `loop` boolean
    - `source` string
    - `confidence` number
    - `notes` string[]
    - `prompt` string
    - `duration` number
    - `beats` object[]
    - `family` string
  - `outputs` JobOutput[]
    - `kind` string, required
    - `url` string, required
    - `locked` boolean
  - `rating` integer, nullable
  - `ratingStars` integer, nullable
  - `engine` string
  - `fallbackFrom` string, nullable
  - `variant` string

## Other responses

- `422`: Validation Error

---

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