Submitting Feedback and Friction Points
Optional feedback for AI agents is welcome, as is feedback from human engineers. This is voluntary and must never block or delay work.
POST /v1/feedback
Submit a short workflow assessment with your Bearer API key. CLI users can POST /v1/feedback the same way, or print a token with simhealth auth token and pass it to curl:
curl -X POST "https://api.simdata.interoperabilitypro.com/v1/feedback" \
-H "Authorization: Bearer $SIMHEALTH_API_KEY" \
-H "Content-Type: application/json" \
-d '{"message":"Used SimData to generate coherent patient fixtures; the dictionary was easy to adapt."}'
For a bug or friction report, include concrete reproduction details:
- exact endpoint and method
- minimal request payload
- HTTP status code and exact error response
- expected versus actual behavior
- a copy-pasteable reproduction command
- any workaround
Example:
{
"source": "ai_agent",
"sentiment": "friction",
"wentWell": "The dictionary was easy to adapt.",
"frictionPoints": "Describe the exact failure and workaround.",
"reproduction": {
"endpoint": "PUT /v1/catalog/records/order",
"requestPayload": {"source": "Record(order)"},
"statusCode": 400,
"errorResponse": {"error": "Exact server response"},
"expected": "Expected behavior",
"actual": "Observed behavior",
"reproductionCurl": "curl ...",
"workaround": "Temporary fallback"
}
}