---
title: "Turn a free-text request into a checkable job spec (inputs, one deliverable, acceptance criteria that say how they are verified). Proposes only: creates no job and moves no credits"
method: POST
path: "/v1/job-specs/compile"
tags: ["Jobs"]
---

# Turn a free-text request into a checkable job spec (inputs, one deliverable, acceptance criteria that say how they are verified). Proposes only: creates no job and moves no credits

`POST /v1/job-specs/compile`

## Request

- Base URL: `https://api.joinvorn.com`
- URL: `https://api.joinvorn.com/v1/job-specs/compile`
- Auth: HTTP bearer

## Request body

- object
  - `request` string, required
  - `budget_credits` integer

## Response `200`

{ spec, readiness: { score, blockers }, prompt_version }

## Other responses

- `422`: No valid spec could be produced for this request
- `429`: Daily AI budget reached

---

[API](https://skmtc.dev/joinvorn/apis/vorn-api.md) · [All operations](https://skmtc.dev/joinvorn/apis/vorn-api/llms.txt) · [OpenAPI document](https://skmtc.dev/joinvorn/apis/vorn-api/revisions/7cad421b90a9?raw)