Skip to content
Documentation menu
docs / api / post-v1-feedback
Feedback and map issues

POST/v1/feedback

Access and price

AuthAn API key, as Authorization: Bearer snk_… or ?api_key=snk_…. Not metered: it draws no quota and no credit. Needs a full key; a browser (maps) key is refused.
PriceNot metered: no quota, no credit.

What it does

Store one integration retro. Never charged; capped at RETROS_PER_KEY_PER_DAY per key per rolling 24 hours.

An API key, as Authorization: Bearer snk_… or ?api_key=snk_…. Not metered: it draws no quota and no credit.

Call it

bash
curl -fsS -X POST "https://api.mapmap.ai/v1/feedback" \
  -H "Authorization: Bearer $MAPMAP_KEY" \
  -H "Content-Type: application/json" \
  -d '{"what_built":"string"}'

Request body

application/json · IntegrationRetroRequest

FieldTypeRequiredDescription
agent_namestringnoThe submitting agent's name, when sent by an AI agent (at most 100 bytes).
docs_gapsstring[]noDocumentation gaps hit (at most 20 × 500 bytes).
gotchasstring[]noSurprises/traps worth documenting (at most 20 × 500 bytes).
problemsRetroProblem[]noProblems hit (at most 20).
sdk_versionstringnoMapMap SDK version integrated against, when known (at most 50 bytes).
what_builtstringyesWhat was built with MapMap (required, at most 500 bytes).
winsstring[]noWhat went well (at most 20 × 500 bytes).

Example: A request assembled from this schema's own field examples, enums, defaults and types; not a recorded call

json
{
  "what_built": "string"
}

Responses

202Retro stored
FieldTypeRequiredDescription
idstringyesStored retro id (UUID v4).
statusstringyesAlways received.

Example: A response assembled from this schema's own field examples, enums, defaults and types; not a recorded call

json
{
  "id": "string",
  "status": "string"
}
400Schema violation: missing what_built, unknown problem area, over-long field or over-long list

application/problem+json · Problem

401Missing or invalid API key. Also: No key, or a missing, malformed, unknown, revoked or expired one (unauthorized)

application/problem+json · Problem

403A browser (maps-scoped) key on a route that needs a full-scope key (scope-insufficient)

application/problem+json · Problem

413The request declares a body larger than 1048576 bytes (plain text, not problem+json)

text/plain

429This key has hit its daily retro cap

application/problem+json · Problem

504The request did not finish within the gateway's request deadline (request-timeout)

application/problem+json · Problem

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

Also under Feedback and map issues

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