Documentation menu
POST/v1/feedback
Access and price
| Auth | An 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. |
|---|---|
| Price | Not 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
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
| 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). |
Example: A request assembled from this schema's own field examples, enums, defaults and types; not a recorded call
{
"what_built": "string"
}Responses
| Field | Type | Required | Description |
|---|---|---|---|
| id | string | yes | Stored retro id (UUID v4). |
| status | string | yes | Always received. |
Example: A response assembled from this schema's own field examples, enums, defaults and types; not a recorded call
{
"id": "string",
"status": "string"
}application/problem+json · Problem
unauthorized)application/problem+json · Problem
maps-scoped) key on a route that needs a full-scope key (scope-insufficient)application/problem+json · Problem
text/plain
application/problem+json · Problem
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