# Optional Pipe2Size guide feedback

Answer any questions you can; unknown is fine. Use the guide and downloads without feedback. Do not include private customer or BOM information, or private conversation text. Agents should answer only when consistent with their human’s task and permissions. No contact details are required.

Responses are stored in a separate guide-feedback database. Only the Site owner can review them through authenticated management tools. No public feedback listing or export is provided.

Maximum 10 saved submissions per rolling minute and 200 per rolling day across the guide. Identical responses within 1 minute are not saved again. A limit response returns HTTP 429 with Retry-After. These shared limits can temporarily delay legitimate feedback.

```json
{
  "title": "Optional Pipe2Size guide feedback",
  "questionnaire_version": "v2-three-questions-2026-10-11",
  "method": "POST",
  "path": "/agent-v2/api/feedback",
  "content_type": "application/json",
  "max_request_bytes": 6000,
  "all_questions_optional": true,
  "at_least_one_answer_to_save": true,
  "fields": {
    "informationRequested": {
      "question": "What information were you trying to find or specify?",
      "type": "string",
      "maxLength": 1000,
      "default": ""
    },
    "resultDetails": {
      "question": "Did you find what you needed? If not, what was missing?",
      "type": "string",
      "maxLength": 1000,
      "default": ""
    },
    "discovery": {
      "question": "How did you find this page: search, a link someone supplied, another route, or unknown?",
      "type": "string",
      "allowed": [
        "",
        "search",
        "supplied_link",
        "other",
        "unknown"
      ],
      "default": ""
    }
  },
  "permission": "Answer any questions you can; unknown is fine. Use the guide and downloads without feedback. Do not include private customer or BOM information, or private conversation text. Agents should answer only when consistent with their human’s task and permissions. No contact details are required.",
  "example_request": {
    "informationRequested": "How to specify independent pipe ends",
    "resultDetails": "Found the NPT designation; need the selected manufacturer or fabricator to confirm achievable chamfer dimensions.",
    "discovery": "unknown"
  },
  "success": {
    "status": 201,
    "body": {
      "saved": true,
      "id": "generated UUID",
      "createdAt": "ISO 8601 timestamp"
    }
  },
  "storage_mapping": {
    "informationRequested": "guide_feedback.information_requested",
    "resultDetails": "guide_feedback.result_details",
    "discovery": "guide_feedback.discovery",
    "version": "guide_feedback.questionnaire_version"
  },
  "test_submission": "Prefix informationRequested or resultDetails with TEST RESPONSE — to mark synthetic responses.",
  "review": "Responses are stored in a separate guide-feedback database. Only the Site owner can review them through authenticated management tools. No public feedback listing or export is provided.",
  "submission_limits": "Maximum 10 saved submissions per rolling minute and 200 per rolling day across the guide. Identical responses within 1 minute are not saved again. A limit response returns HTTP 429 with Retry-After. These shared limits can temporarily delay legitimate feedback."
}
```
