SIMDATA

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"
  }
}

View Markdown source