confirm_report

Contract

shape

entity

authority

act

evidence

none

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

natural

emits

none

MCP tool

confirm_report

decision_set

approve, reject

REST

POST https://api.containertradehq.com/v1/cap/confirm_report

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

Idempotency: keyed by the contract's own inputs: the same inputs replay the first call's result

Inputs

Response

• report_id · string · The report.
• ticket · string · The report's reference (CUS-n).
• confirmed_at · string · When you confirmed it: the first time, on every later call.

{
  "type": "object",
  "properties": {
    "report_id": {
      "type": "string",
      "pattern": "^[0-9A-Fa-f]{8}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{4}-[0-9A-Fa-f]{12}$",
      "format": "uuid",
      "description": "The report.",
      "x-data-class": "operational"
    },
    "ticket": {
      "type": "string",
      "description": "The report's reference (CUS-n).",
      "x-data-class": "operational"
    },
    "confirmed_at": {
      "type": "string",
      "format": "date-time",
      "description": "When you confirmed it: the first time, on every later call.",
      "x-data-class": "operational"
    }
  },
  "required": [
    "report_id",
    "ticket",
    "confirmed_at"
  ],
  "additionalProperties": false
}

Refusals

• report_not_found · 422 · the org has no such report, or it is private to its reporter
• report_not_confirmable · 422 · only a Fixed or Answered report is confirmed
• confirmation_not_recorded · 422 · the confirmation could not reach Trade HQ support just now; send it again
• reports_unavailable · 422 · this deployment has no broker credential for reports yet; nothing was sent

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

Surfaces

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

Events

None emitted.

Related

follow_report, get_report, mark_report_seen, reopen_report, reply_to_report, unfollow_report