> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dacard.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Submit feedback

> Submit thumbs up/down + structured reaction on a coaching response, score, or recommendation.

Submit feedback on a DAC artifact: thumbs up/down plus an optional structured reaction. The reaction taxonomy (helpful, already doing, wrong diagnosis, wrong priority, not actionable, implemented differently) feeds the coaching engine's per-recommendation acceptance rate.

```bash theme={null}
curl -X POST https://app.dacard.ai/api/feedback \
  -H "Authorization: Bearer $DACARD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "targetType": "recommendation",
    "targetId": "rec_xyz",
    "rating": "down",
    "reaction": "wrong_diagnosis",
    "comment": "We already shipped that two cycles ago.",
    "traceId": "trace_xyz"
  }'
```

| Property | Value |
| - | - |
| **Auth** | Required |
| **Idempotent** | Yes (replaces caller's prior feedback on the same target) |

## Body

| Field | Type | Required | Notes |
| - | - | - | - |
| `targetType` | `recommendation` \| `score` \| `chat_response` \| `briefing` | yes | What's being rated. |
| `targetId` | string | yes | The id of the artifact. |
| `rating` | `up` \| `down` | yes | Thumbs. |
| `reaction` | string | no | One of: `helpful`, `already_doing`, `wrong_diagnosis`, `wrong_priority`, `not_actionable`, `implemented_differently`. |
| `comment` | string | no | Free text. |
| `traceId` | string | no | The trace ID returned with the original artifact. Wires the outcome chain. |

## Errors

| Status | Code | When |
| - | - | - |
| 400 | `INVALID_PAYLOAD` | Missing required fields. |
| 401 | `AUTH_REQUIRED` | No session. |
| 404 | `Target not found` | `targetId` doesn't exist. |
| 500 | `INTERNAL_ERROR` | Write failed. |

If `traceId` is provided, the row joins to `llm_traces` for the outcome chain. See `.claude/rules/observability.md` for the contract.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.