send_feedback · Send feedback or report a problem

Contract

shape: entity
authority: act
evidence: optional
subscription: false
permission: any one of: org.member (carried by the caller's role template in the org `org_id`); a deactivated caller is refused first
idempotency: keyed
emits: none
MCP tool: send_feedback
decision_set: approve, reject
REST: POST https://api.containertradehq.com/v1/cap/send_feedback

Through MCP this call returns an approval request first; see Approvals.

Idempotency: keyed by the caller's Idempotency-Key, which is required: the same key and inputs replay the first result, the same key with other inputs is 409 idempotency_key_reused

Inputs

name	type	required	validation
org_id	org_id	required	tradehq-org-id; 1 to 20 characters The org you are sending it for: the one you are signed in to.
kind	one_of	required	one of feedback, problem feedback (Send feedback) or problem (Report a problem).
message	text	required	1 to 5000 characters What you think, or what went wrong and what you expected.
impact	one_of	required	one of blocking, slowing, suggestion How much it hurts: blocking (Blocking my work), slowing (Slowing me down) or suggestion (Suggestion).
page	text	required	1 to 512 characters The path of the page you are on, e.g. /orders. A query or fragment is cut off.
record	record	optional	The record the page shows, when it shows one: its kind (order, intake, party, share, received_share, release, gate_in, gate_out, audit_schedule, report) and id. The report links to it and never carries its contents.
private	boolean	optional	Only me and Trade HQ: true shows the report to you and to Trade HQ alone, never to the rest of your org. Not given is false: the whole org sees it.
build	text	optional	1 to 64 characters The app's build, its commit, when the app knows it.
browser	text	optional	1 to 400 characters The browser's user agent.
recent_errors	recent_errors	optional	0 to 5 items The last errors the app saw, newest last, at most five.
screenshot	screenshot	optional	An image to attach (PNG, JPEG or WebP, at most 1 MiB), as base64.

Response

feedback_id · string · The report: fb and thirty characters, derived from the Idempotency-Key.
reference · string · The reference support files it under, to quote when you write to them.
screenshot · string · Whether the screenshot was attached: failed means the report was filed without it.

Full JSON Schema

{
  "type": "object",
  "properties": {
    "feedback_id": {
      "type": "string",
      "description": "The report: fb and thirty characters, derived from the Idempotency-Key.",
      "x-data-class": "operational"
    },
    "reference": {
      "type": "string",
      "description": "The reference support files it under, to quote when you write to them.",
      "x-data-class": "operational"
    },
    "screenshot": {
      "type": "string",
      "enum": [
        "attached",
        "failed",
        "none",
        "skipped"
      ],
      "description": "Whether the screenshot was attached: failed means the report was filed without it.",
      "x-data-class": "operational"
    }
  },
  "required": [
    "feedback_id",
    "reference",
    "screenshot"
  ],
  "additionalProperties": false
}

Refusals

feedback_unavailable · 422 · this deployment has no broker credential for feedback yet; nothing was sent
bad_page · 422 · page is not a path in the app (/...)
feedback_not_filed · 422 · the report could not be filed just now; send it again with the same Idempotency-Key
retry_key_mismatch · 409 · the Idempotency-Key was already used with a different report
retry_key_in_flight · 409 · a request with this Idempotency-Key is still running
retry_key_lost · 409 · another request took over this Idempotency-Key first

The platform refusals apply to every call: version, authentication, authority, validation and rate limits, each in the same envelope.

Surfaces

DesktopF

MobileF

APIF

MCPF*

VoiceD2

PushN

OneBoxN

OutboundN

MCP: approval required
Voice: degraded: confirmation
Push: emits nothing
OneBox: a report is written by a person, not read off a document
Outbound: goes to Trade HQ's support, never to a counterparty

Events

None emitted.

grant_capability