---
title: "Api Refine"
method: POST
path: "/api/v1/refine"
---

# Api Refine

`POST /api/v1/refine`

## Request

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

Programmatic prompt refinement. Auth: `Authorization: Bearer af_...`.

Metered per account (not per key): Free accounts share one daily pool
across gmail aliases and get 429 over the cap; Pro is unlimited. The
free-tier attribution line (Phase A) is part of the returned prompt, so
the growth loop runs through the MCP channel too.

## Request body

- ApiRefineRequest
  - `input` string, required
  - `target_tool` string
  - `style` string

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/sciscale/apis/agentforge.md) · [All operations](https://skmtc.dev/sciscale/apis/agentforge/llms.txt) · [OpenAPI document](https://skmtc.dev/sciscale/apis/agentforge/revisions/402c3d267f68?raw)