Send Product Feedback to the RedditAPIs Team from an AI Agent
Report a bug, an idea or a missing capability to the RedditAPIs team over one free POST. Built for AI agents, drafted locally by the MCP server and sent only after you review it.
/feedbackFreeReport a bug, an idea or a missing capability to the RedditAPIs team. Free, does not consume credits. Rate-limited to 10 requests per minute per API key.
This endpoint exists for AI agents. The official MCP server (redditapis-mcp, tool reddit_feedback_send) drafts a report into a local queue at the moment a tool fails or a capability is missing, and posts it here only after you review the queue and name the drafts to send. You can also call it directly from any client.
Request Body
JSON object. Every rejection is a 400 whose body names the field to fix, so an agent can repair the call instead of retrying blind.
| Field | Type | Required | Description |
|---|---|---|---|
type | string | Yes | bug (an endpoint or tool misbehaved), idea (a change that would have made the task easier), or missing_capability (something no endpoint provides). |
title | string | Yes | One specific line naming the endpoint or tool and the defect. 1 to 120 characters. |
details | string | Yes | What happened (observed vs expected), what the user said, a minimal repro, and the evidence. 1 to 8000 characters. |
area | string | No | The endpoint or feature the report is about, e.g. posts/comments or monitoring. At most 80 characters. |
evidence | object | No | Identifiers only, never payloads: tool, endpoint, status, request_id, client, mcp_version. Must serialize to 4096 bytes or fewer. |
client | string | No | The client that sent the report, e.g. claude-code/2.1.259 via redditapis-mcp@0.4.0. At most 120 characters. |
Success Response
201 Created
{
"id": "33333333-3333-4333-8333-333333333333",
"status": "new",
"created_at": "2026-09-04T10:14:22.318401+00:00"
}| Field | Description |
|---|---|
id | The report's server id. Pass it to Feedback Status later. |
status | Always new on creation. Moves to triaged, shipped or declined when the team acts. |
created_at | When the report was received. |
Example
curl -X POST "https://api.redditapis.com/feedback" \
-H "Authorization: Bearer $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"type": "bug",
"title": "GET /api/reddit/comments returns 502 when the post is deleted",
"details": "- What happened: 502 upstream error instead of a 404\n- What the user said: user did not comment\n- Repro: GET /api/reddit/comments?permalink=/r/webdev/comments/abc123/x\n- Evidence: status 502, request id req_9f2",
"area": "posts/comments",
"evidence": { "endpoint": "/api/reddit/comments", "status": 502, "request_id": "req_9f2" },
"client": "my-agent/1.0"
}'const response = await fetch("https://api.redditapis.com/feedback", {
method: "POST",
headers: { Authorization: "Bearer TOKEN", "Content-Type": "application/json" },
body: JSON.stringify({
type: "missing_capability",
title: "No endpoint returns a subreddit's flair list",
details: "- What happened: the user asked for the flairs of r/webdev\n- What the user said: \"can you list the post flairs?\"\n- Repro: n/a\n- Evidence: no matching endpoint in openapi.json",
area: "listings",
}),
});
const { id, status } = await response.json();import requests
response = requests.post(
"https://api.redditapis.com/feedback",
headers={"Authorization": "Bearer TOKEN"},
json={
"type": "idea",
"title": "Let /api/reddit/search accept several subreddits at once",
"details": "- What happened: the user searched 6 subreddits one call each\n- What the user said: \"this is slow\"\n- Repro: 6x GET /api/reddit/search?subreddit=...\n- Evidence: n/a",
"area": "search",
},
)
report = response.json() # {"id": ..., "status": "new", "created_at": ...}Errors
| Status | Meaning |
|---|---|
400 | { "error": "invalid_request", "field": "...", "message": "..." }. The body was not a JSON object, or the named field is missing, the wrong type, or over its limit. |
401 | Missing or invalid Bearer token |
429 | Rate limit exceeded (more than 10 reports per minute on one key) |
500 | Unexpected server error |
502 | The feedback service is temporarily unavailable; retry in a moment |
Independent third-party API for developers and researchers. Not affiliated with, endorsed by, or sponsored by Reddit, Inc.
Payment History
List the top-ups and payments made to your account, sorted newest first. Free to call, useful for invoicing, accounting, and reconciling credit purchases.
Feedback Status
Read whether a feedback report your account sent was triaged, shipped or declined, and the team's response. Free, no per-call cost, scoped to the sending account.
