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

# Run CLI code review

`POST /cli/review`

Runs a code review using a Team CLI key passed via `x-team-key` or `Authorization: Bearer <team-key>`.

## Headers

- `x-team-key` string
- `authorization` string, required

## Request body

- CliReviewRequestDto
  - `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

## Response `200`

- CliReviewResponseDto
  - `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

## Other responses

- `400` — Validation error
- `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)