Skip to content

Feedback

Submit AgentFeedbackEvidence

POST /api/v1/feedback/{id}/attachments

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
postAgentFeedbackEvidence
Access
anonymous
Automatic retries
None
Redirects
Returned to the caller without following
Request body limit
48000 UTF-8 bytes
Pagination
No collection iterator

Parameters

id string required

Request body

application/json

object | object[] required

Schema details

object

Schema details

type string required

Allowed: "http_summary" | "stderr_excerpt" | "repro_steps" | "screenshot" | "log_excerpt" | "other"

content string required

redacted boolean

object[]

Schema details

object

Schema details

type string required

Allowed: "http_summary" | "stderr_excerpt" | "repro_steps" | "screenshot" | "log_excerpt" | "other"

content string required

redacted boolean

object

Schema details

evidence object[] required

Schema details

object

Schema details

type string required

Allowed: "http_summary" | "stderr_excerpt" | "repro_steps" | "screenshot" | "log_excerpt" | "other"

content string required

redacted boolean

Responses

201

Feedback protocol response

application/json

object

Schema details

data object required

Schema details

feedback_id string required

evidence_ids string[] required

Schema details

string

created_at string 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 POST 'https://irvinebroque.com/api/v1/feedback/fb_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa/attachments' --header 'Accept: application/json' --header 'Content-Type: application/json' --data-binary @request.json

TypeScript

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

CLI

irvinebroque feedback attach --id 'fb_aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa' --body-file request.json

request.json

{
  "type": "http_summary",
  "content": "fixture"
}

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.