Submit feedback - Dacard.ai

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.

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.

​Body

​Errors

Body

Errors