Feedback
Read AgentFeedbackReceipt
HEAD /api/v1/receipts/{id}
feedback.now v1 receiver. Private untrusted reports, inline evidence, 90-day retention; never changes public content. HTTP and MCP writes share 60 submissions/hour per source and 240/hour site-wide. Obtain user approval when required by your host. Receipt IDs are bearer references; receipts contain status only. Acceptance means stored, not verified. No automatic submission retries.
Request policy
- Operation
headAgentFeedbackReceipt- Access
- anonymous
- Automatic retries
- None
- Redirects
- Returned to the caller without following
- Request body limit
- No request body
- Pagination
- No collection iterator
Parameters
id string required
Responses
200
Feedback response headers
400
Feedback request failed. Errors contain error and message. Never automatically retry submissions.
application/json
object
Schema details
error string required
message string required
403
Feedback request failed. Errors contain error and message. Never automatically retry submissions.
application/json
object
Schema details
error string required
message string required
404
Feedback request failed. Errors contain error and message. Never automatically retry submissions.
application/json
object
Schema details
error string required
message string required
413
Feedback request failed. Errors contain error and message. Never automatically retry submissions.
application/json
object
Schema details
error string required
message string required
415
Feedback request failed. Errors contain error and message. Never automatically retry submissions.
application/json
object
Schema details
error string required
message string required
429
Feedback request failed. Errors contain error and message. Never automatically retry submissions.
application/json
object
Schema details
error string required
message string required
503
Feedback request failed. Errors contain error and message. Never automatically retry submissions.
application/json
object
Schema details
error string required
message string required
Examples
Examples use synthetic fixture values. Replace fixture identifiers with public IDs returned by the service. Request bodies and precise locations are transient; keep them out of logs.
curl
curl --fail-with-body --max-time 30 --max-filesize 16777216 --head 'https://irvinebroque.com/api/v1/receipts/rcpt_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'TypeScript
import { PublicApi } from '@irvinebroque/public-api';
const api = new PublicApi();
const result = await api.feedback.receiptHead({
"id": "rcpt_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
});
console.log(result.status, result.headers.get('content-type')); // Keep transient capabilities in memory.CLI
irvinebroque feedback receipt-head --id 'rcpt_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa'The SDK preserves status, headers, and the server envelope. A 304 has no fresh body. Errors retain structured problem details; ordinary error messages omit response details. Responses are limited to 16 MiB and requests time out after 30 seconds by default.