API Reference

POST /v1/reports

{
  "ingest_key": "wk_your_ingest_key",
  "outcome": "failure",
  "details": "What the agent tried and what happened",
  "tool_name": "optional — the specific tool or endpoint",
  "source": "optional — name of your skill, MCP server, or API"
}

{ "ok": true, "id": "5fedcdff6fde60fe35214876abada9a1" }

curl -X POST https://api.writeback.dev/v1/reports \
  -H "Content-Type: application/json" \
  -d '{
    "ingest_key": "wk_your_ingest_key",
    "outcome": "confusing",
    "tool_name": "search_index",
    "details": "Parameter name in docs says query but the actual field name is q. Got a 400 until I guessed correctly."
  }'

GET /v1/projects
Authorization: Bearer wk_sk_your_api_key

[
  {
    "id": "bf9166a67ee9834f16850d3794b10e93",
    "name": "my-project",
    "created_at": "2026-02-20T11:06:14Z"
  }
]

GET /v1/dashboard/:projectId/reports
Authorization: Bearer wk_sk_your_api_key

{
  "project": { "id": "...", "name": "my-project" },
  "stats": {
    "total": 41,
    "success": 25,
    "failure": 5,
    "confusing": 8,
    "gave_up": 0,
    "request": 3
  },
  "reports": [
    {
      "id": "...",
      "outcome": "failure",
      "tool_name": "search_index",
      "source": "my-mcp-server",
      "details": "...",
      "created_at": "2026-02-20T13:02:23Z"
    }
  ],
  "pagination": { "page": 1, "limit": 50, "total": 41 }
}