---
title: "Review Superpowers intent and a proposed Kata graph edit"
method: POST
path: "/api/goal-review"
tags: ["reviews"]
---

# Review Superpowers intent and a proposed Kata graph edit

`POST /api/goal-review`

## Request

- The document declares no server URL.
- Auth: none declared

## Request body

- GoalGateRequest
  - `candidate` Candidate
    - `body` string, required
    - `labels` string[], nullable
    - `links` CandidateLink[], nullable
      - `incoming` boolean
      - `to_ref` string, required
      - `type` string, required
    - `short_id` string
    - `title` string, required
  - `plan_file` string
  - `repo_path` string, required
  - `spec_file` string

## Response `200`

HTTP 200 response

- GoalGateResponse
  - `$schema` string, uri: A URL to the JSON Schema for this object.
  - `blocked` boolean, required
  - `error` string
  - `findings` Finding[], required
    - `fix` string, required
    - `location` Location, required
      - `file` string
      - `kata_id` string
      - `line` integer
    - `message` string, required
    - `severity` string, required
  - `mode` string, required
  - `snapshot_id` string
  - `status` string, required
  - `version` integer, required

## Other responses

- `400`: HTTP 400 response
- `503`: HTTP 503 response

## Changes

- **2026-10-04** `c12542ad5f2a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kenn-io/apis/roborev/changes/api/goal-review/post.md)

---

[API](https://skmtc.dev/kenn-io/apis/roborev.md) - [All operations](https://skmtc.dev/kenn-io/apis/roborev/llms.txt) - [OpenAPI document](https://skmtc.dev/kenn-io/apis/roborev/revisions/5803a85073e3?raw)