---
title: "Refine Deal"
method: POST
path: "/api/prospecting/deals/{deal_id}/refine"
tags: ["prospecting"]
---

# Refine Deal

`POST /api/prospecting/deals/{deal_id}/refine`

Refresh strategy + draft for a single deal using new context.

The user types into the dialog's "Refine plan" card; this enqueues a
`pipeline_deal_replan` job carrying the user_context and a fresh
`pipeline_run_token`. Older queued replans for this deal abort as
`superseded` once they pick up. Does not queue a cross-deal learning
signal — this input is a per-deal refinement only.

## Query parameters

- `user_id` string, nullable
- `org_id` string, nullable

## Request body

- RefineDealRequest — Manual user-supplied context that should refresh this deal's strategy + draft. Does not queue a cross-deal skill-learning signal.
  - `user_context` string, required

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/every/apis/every-api.md) · [All operations](https://skmtc.net/every/apis/every-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/every/every-api/versions/f8600f7a4ae3/schema)