---
title: "Run trial CLI code review"
method: POST
path: "/cli/trial/review"
tags: ["CLI Review"]
---

# Run trial CLI code review

`POST /cli/trial/review`

Runs a trial code review (no auth). Requires `fingerprint` and is rate-limited by device.

## Request body

- TrialCliReviewRequestDto
  - `diff` string, required
  - `config` CliConfigDto
    - `severity` string
    - `rules` CliReviewRulesDto
      - `security` boolean
      - `performance` boolean
      - `style` boolean
      - `bestPractices` boolean
    - `rulesOnly` boolean
    - `fast` boolean
    - `files` CliFileInputDto[]
      - `path` string, required
      - `content` string, required
      - `status` 'added' | 'modified' | 'deleted' | 'renamed', required
      - `diff` string, required
  - `userEmail` string
  - `gitRemote` string
  - `branch` string
  - `commitSha` string
  - `inferredPlatform` 'INTERNAL' | 'GITHUB' | 'GITLAB' | 'JIRA' | 'SLACK' | 'NOTION' | 'MSTEAMS' | 'DISCORD' | 'AZURE_BOARDS' | 'AZURE_REPOS' | 'KODUS_WEB' | 'BITBUCKET'
  - `cliVersion` string
  - `fingerprint` string, required

## Response `200`

- TrialCliReviewResponseDto
  - `summary` string, required
  - `issues` CliReviewIssueDto[], required
    - `file` string, required
    - `line` number, required
    - `endLine` number
    - `severity` string, required
    - `category` string
    - `message` string, required
    - `suggestion` string
    - `recommendation` string
    - `ruleId` string
    - `fixable` boolean
    - `fix` CliReviewIssueFixDto
      - `range` CliReviewIssueFixRangeDto, required
        - `start` number, required
        - `end` number, required
      - `replacement` string, required
  - `filesAnalyzed` number, required
  - `duration` number, required
  - `rateLimit` CliReviewRateLimitDto
    - `remaining` number, required
    - `limit` number, required
    - `resetAt` string

## Other responses

- `400` — Missing device fingerprint
- `401` — Not authenticated
- `403` — Insufficient permissions
- `429` — Rate limit exceeded
- `500` — Unexpected error

---

[API](https://skmtc.net/kodustech/apis/kodus-api.md) · [All operations](https://skmtc.net/kodustech/apis/kodus-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kodustech/kodus-api/revisions/e2282ac5fb3a/schema)