---
title: "Report issue"
method: POST
path: "/report_issue"
---

# Report issue

`POST /report_issue`

## Request

- Base URL: `https://newsmind.app/api/v1`
- URL: `https://newsmind.app/api/v1/report_issue`
- Auth: OAuth 2 (authorization code, authorization URL `https://newsmind.app/oauth/authorize`, token URL `https://newsmind.app/oauth/token`, scopes: `mcp`)

File a bug report, feature request, or feedback. Server stores it (visible only to the developer) and emails the owner. Returns the issue ID. Rate-limited to 10/user/day.

## Request body

- object
  - `kind` 'bug' | 'feature_request' | 'feedback', required: bug = something broke or didn't behave as expected; feature_request = user wants a capability that doesn't exist; feedback = general comment, praise, or critique.
  - `title` string, required: One-line summary, like a GitHub issue title.
  - `body` string, required: Detailed description. Include reproducer steps, article/feed IDs that were involved, what was expected vs. what happened, and any other context the developers should see.

## Response `200`

Success

- object
  - `id` integer
  - `kind` string
  - `message` string

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `402`: Subscription required (trial expired or cancelled)
- `429`: Too many calls. Either the per-account rate limit ({error: "rate_limited", message}) or the account's in-flight work ({error: <sentence>, code: "busy"}). Wait Retry-After seconds.
- `500`: Server error on our side (error: internal_error). The team has been notified.
- `503`: Temporarily unable to answer. error: timeout (the request ran too long; narrow it), server_busy or tier_unavailable (retry after Retry-After seconds when sent).

---

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