Thumbs up/down on a knowledge-grounded chat answer
POST/v1/knowledge_feedback
Stores only ids and the rating — never the question or answer text. One vote per (organization, request_id); a new vote replaces the old one. All knowledge base and document ids must belong to your organization (else 404) and pass the key's allowlist (else 403).
Access: API key scope knowledge:read or knowledge:write; portal users: any member of the organization; every knowledge base in the body must be on the key's access list.
Request
Responses
- 200
- 403
- 404
- 422
Stored.
scope_missing, kb_not_in_allowlist, role_insufficient, actor_not_permitted, tenant_suspended, module_disabled (knowledge bases switched off on the platform: an operation that creates data or starts processing, for an organization that still has knowledge bases), web_sources_disabled, domain_blocked, domain_not_verified (website sources)
not_found (absent or owned by another organization — identical), module_disabled
validation_failed, invalid_identifier, metadata_*, filter_invalid, query_too_long, batch_too_large, file-type codes, https_required, source_url_rejected, robots_disallowed, ai_signal_optout, attestation_required, terms_acceptance_required