---
title: "Post Kol Outreach Rewrite"
method: POST
path: "/api/kols/{username}/outreach/rewrite"
tags: ["KOL Database"]
---

# Post Kol Outreach Rewrite

`POST /api/kols/{username}/outreach/rewrite`

## Request

- Base URL: `https://api.kolens.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kolens.ai/api/kols/{username}/outreach/rewrite`
- Auth: HTTP bearer

Rewrite the cached EN outreach draft per the operator's
instruction (e.g. "make it more casual", "mention their latest
product review"). Reads the existing draft from cache, runs one
LLM call, upserts the rewritten draft back into the same row.
Costs ``settings.outreach_rewrite_cost_credits`` (default 1).

Charge-then-generate semantics (same pattern as deep-overview):
  - 402 if combined workspace + personal balance can't cover it.
  - On AIGatewayError after the debit, the workspace half is
    refunded immediately; the personal half — if any — needs the
    operator to mail-in support.

## Path parameters

- `username` string, required

## Headers

- `x-kolens-user-id` string, nullable
- `x-kolens-workspace-id` string, nullable

## Request body

- OutreachRewriteRequest
  - `instruction` string, required

## Response `200`

Successful Response

- OutreachDraftResponse
  - `dm` string, required
  - `email_subject` string, required
  - `email_body` string, required
  - `generated_at` string, required
  - `model_used` string, nullable
  - `cached` boolean, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kolens/apis/kolens-api.md) · [All operations](https://skmtc.dev/kolens/apis/kolens-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolens/apis/kolens-api/revisions/5d6865ab0a24?raw)