Skip to content

Feedback

Read AgentFeedbackReceipt

GET /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.

Markdown · Authoritative OpenAPI

Request policy

Operation
getAgentFeedbackReceipt
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 protocol response

application/json

object

Schema details

data object required

Schema details

id string required

feedback_id string required

Schema details

string

unknown

observation_id string required

Schema details

string

unknown

status string required

Allowed: "accepted" | "needs_more_evidence" | "duplicate" | "rejected" | "queued"

created_at string required

quality_score number required

duplicate_of string required

budget_remaining number required

budget_delta number required

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 --request GET 'https://irvinebroque.com/api/v1/receipts/rcpt_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' --header 'Accept: application/json'

TypeScript

import { PublicApi } from '@irvinebroque/public-api';
const api = new PublicApi();
const result = await api.feedback.receipt({
  "id": "rcpt_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa"
});
console.log(result.status, result.headers.get('content-type')); // Keep transient capabilities in memory.

CLI

irvinebroque feedback receipt --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.