---
title: "Refine Requirement"
method: POST
path: "/requirements/refine"
tags: ["requirements"]
---

# Refine Requirement

`POST /requirements/refine`

## Request

- Base URL: `https://api.specproof.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.specproof.ai/requirements/refine`
- Auth: none declared

LLM refinement: decompose a requirement into atomic condition/action pieces
(cite-or-abstain — grounded strictly in the source sentence).

## Headers

- `X-Org-Id` string, nullable
- `authorization` string

## Request body

- RefineRequest
  - `requirement_id` integer, nullable
  - `text` string, nullable
  - `obligation` string, nullable
  - `actor` string, nullable
  - `spec_number` string, nullable
  - `section_title` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/specproof/apis/specproof-portal-api.md) · [All operations](https://skmtc.dev/specproof/apis/specproof-portal-api/llms.txt) · [OpenAPI document](https://skmtc.dev/specproof/apis/specproof-portal-api/revisions/228b03caa929?raw)