POST/v1/feedback

API key required, sent as Authorization: Bearer snk_… or ?api_key=snk_….

Call it

bash

curl -fsS -X POST "https://api.mapmap.ai/v1/feedback" \
  -H "Authorization: Bearer $MAPMAP_KEY" \
  -H "Content-Type: application/json" \
  -d @request.json

Request body

application/json · IntegrationRetroRequest

Field	Type	Required	Description
agent_name	string	no	The submitting agent's name, when sent by an AI agent (at most 100 bytes).
docs_gaps	string[]	no	Documentation gaps hit (at most 20 × 500 bytes).
gotchas	string[]	no	Surprises/traps worth documenting (at most 20 × 500 bytes).
problems	RetroProblem[]	no	Problems hit (at most 20).
sdk_version	string	no	MapMap SDK version integrated against, when known (at most 50 bytes).
what_built	string	yes	What was built with MapMap (required, at most 500 bytes).
wins	string[]	no	What went well (at most 20 × 500 bytes).

Responses

202Retro stored

Field	Type	Required	Description
id	string	yes	Stored retro id (UUID v4).
status	string	yes	Always `received`.

400Schema violation: missing what_built, unknown problem area, over-long field or over-long list

401Missing or invalid API key

429This key has hit its daily retro cap

Error bodies follow the shared problem model documented on API conventions.

Generated from https://api.mapmap.ai/openapi.json on 2026-09-17 · operationId submit_feedback