# 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:

```bash
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:

```json
{
  "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"
  }
}
```
