---
title: "Execute Task"
method: POST
path: "/tasks/execute"
tags: ["tasks"]
---

# Execute Task

`POST /tasks/execute`

## Request

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

## Request body

- TaskRequest
  - `task` string, required
  - `api_key` string, required
  - `model` string
  - `github_token` string, required
  - `repo` string, required
  - `tenant_id` string, required
  - `project_id` string, required
  - `task_id` string

## Response `200`

Successful Response

- TaskResponse
  - `status` string, required
  - `pr_url` string, nullable
  - `tokens_used` integer
  - `tokens_saved` integer
  - `predicted_impact` string[]
  - `files_read` integer
  - `files_in_repo` integer
  - `model` string
  - `pr_debug` string
  - `tests_passed` boolean
  - `tests_skipped` boolean
  - `commits_ingested` 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)