---
title: "Flag Letter"
method: POST
path: "/letters/{letter_id}/flag"
tags: ["letters"]
---

# Flag Letter

`POST /letters/{letter_id}/flag`

## Request

- Base URL: `https://api.projectindi.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.projectindi.com/letters/{letter_id}/flag`
- Auth: none declared

Flag a delivered letter for review.

The flagger stops seeing the letter immediately; it is withheld from everyone
only once it reaches the flag threshold (see flag_support_letter). The RPC
raises 'letter_not_delivered' when the caller was never delivered this letter
(→ 404) and 'flag_rate_limited' when they've flagged too many recently (→ 429).

## Path parameters

- `letter_id` string, required

## Request body

- FlagLetterRequest
  - `reason` string, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/projectindi/apis/indi-agent-api-first-principles.md) - [All operations](https://skmtc.dev/projectindi/apis/indi-agent-api-first-principles/llms.txt) - [OpenAPI document](https://skmtc.dev/projectindi/apis/indi-agent-api-first-principles/revisions/25a7813e21fd?raw)