---
title: "Unified Execute"
method: POST
path: "/v2/execute"
tags: ["unified-v2"]
---

# Unified Execute

`POST /v2/execute`

## Request

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

## Request body

- UnifiedRequest
  - `project_id` string, required
  - `tenant_id` string, required
  - `instruction` string, required
  - `mode` 'code' | 'test' | 'both' | 'analyze'
  - `changed_files` string[], nullable
  - `language` string
  - `framework` string
  - `api_key` string, nullable
  - `model` string, nullable

## Response `200`

Successful Response

- UnifiedResponse
  - `mode` string, required
  - `code` string, nullable
  - `tests` string, nullable
  - `impact` ImpactDTO, required
    - `changed_symbols` string[], required
    - `affected_symbols` string[], required
    - `affected_files` string[], required
    - `affected_modules` string[], required
    - `related_commits` string[], required
    - `risk_score` number, required
    - `confidence` number, required
    - `breakage_patterns` object[]
    - `predicted_ripple_effects` object[]
    - `related_concepts` object[]
    - `epistemic_gaps` object[]
    - `epistemic_coherence` number
    - `epistemic_source` string
  - `tokens_used` integer
  - `context_tokens` integer

## 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)