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 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. |
traceId is provided, the row joins to llm_traces for the outcome chain. See .claude/rules/observability.md for the contract.
