---
title: "`POST /v1/feedback`: store one integration retro. Never charged; capped at [`RETROS_PER_KEY_PER_DAY`] per key per rolling 24 hours."
method: POST
path: "/v1/feedback"
tags: ["feedback"]
---

# \`POST /v1/feedback\`: store one integration retro. Never charged; capped at \[\`RETROS_PER_KEY_PER_DAY\`\] per key per rolling 24 hours.

`POST /v1/feedback`

## Request

- Base URL: `https://api.mapmap.ai`
- URL: `https://api.mapmap.ai/v1/feedback`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `api_key`

## Request body

- IntegrationRetroRequest: Body for `POST /v1/feedback`.
  - `agent_name` string, nullable: The submitting agent's name, when sent by an AI agent (at most 100 bytes).
  - `docs_gaps` string[]: Documentation gaps hit (at most 20 × 500 bytes).
  - `gotchas` string[]: Surprises/traps worth documenting (at most 20 × 500 bytes).
  - `problems` RetroProblem[]: Problems hit (at most 20).
    - `area` string, required: Platform area, one of [`PROBLEM_AREAS`].
    - `description` string, required: What went wrong (at most 1000 bytes).
    - `workaround_found` boolean, required: Whether a workaround was found.
  - `sdk_version` string, nullable: MapMap SDK version integrated against, when known (at most 50 bytes).
  - `what_built` string, required: What was built with MapMap (required, at most 500 bytes).
  - `wins` string[]: What went well (at most 20 × 500 bytes).

## Response `202`

Retro stored

- IntegrationRetroResponse: Response for `POST /v1/feedback`.
  - `id` string, required: Stored retro id (UUID v4).
  - `status` string, required: Always `received`.

## Other responses

- `400`: Schema violation: missing what_built, unknown problem area, over-long field or over-long list
- `401`: Missing or invalid API key
- `429`: This key has hit its daily retro cap

---

[API](https://skmtc.dev/mapmap/apis/sn-gateway.md) · [All operations](https://skmtc.dev/mapmap/apis/sn-gateway/llms.txt) · [OpenAPI document](https://skmtc.dev/mapmap/apis/sn-gateway/revisions/2293be8b4c38?raw)