---
title: "Generate Tests"
method: POST
path: "/test/generate"
tags: ["vpm-test"]
---

# Generate Tests

`POST /test/generate`

## Request

- Base URL: `https://hokmah.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://hokmah.dev/test/generate`
- Auth: none declared

Generate tests surgically targeted by the VPM graph.
The graph provides ~200 tokens of context vs ~8000 tokens of raw code — ratio ~40x.

## Request body

- TestGenerateRequest
  - `project_id` string, required
  - `tenant_id` string, required
  - `changed_files` string[], nullable
  - `instruction` string
  - `language` string
  - `framework` string
  - `commit_message` string
  - `api_key` string, nullable
  - `model` string, nullable

## Response `200`

Successful Response

- TestGenerateResponse
  - `test_code` string, required
  - `language` string, required
  - `framework` string, required
  - `files_covered` string[], required
  - `symbols_covered` string[], required
  - `invariants_checked` string[], required
  - `risk_score` number, required
  - `confidence` number, required
  - `tokens_used` integer, required
  - `context_tokens` integer, required
  - `savings_ratio` number, required: Baseline tokens / context tokens (approximate)
  - `generation_time_ms` number, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/hokmah/apis/vpm-api.md) · [All operations](https://skmtc.dev/hokmah/apis/vpm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/hokmah/apis/vpm-api/revisions/881edbbedcf8?raw)