Book a demo

replay_event_delivery

Replay an event's delivery

act entity canonical-registry since 2026-10-01

Puts one capability event's delivery back to pending, so every consumer of it hears it again. The event itself is not changed and no new event is written. A delivery that is already pending is left as it is. Requires a reason, which is kept on the replay's audit record. Staff only.

Contract

shape
entity
authority
act
evidence
none
subscription
false
permission
any one of: staff.ops (the staff role staff_ops held in the Internal org, tradehq_role.staff_role); a deactivated caller is refused first
idempotency
natural
emits
none
MCP tool
replay_event_delivery
decision_set
approve, reject
REST
POST https://api.containertradehq.com/v1/cap/replay_event_delivery

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

nametyperequiredvalidation
event_iduuidrequiredUUID
The event whose delivery is replayed.
reasontextrequired1 to 300 characters
Why the delivery is replayed, kept on the replay's audit record: every consumer, customers' webhooks, Slack and digests among them, hears the event again.

Response

  • event_id · string · The event.
  • event_type · string · What the event is, as the capability that emitted it declares it.
  • replays · integer · How many times the event's delivery has been replayed.
Full JSON Schema 
{
  "type": "object",
  "properties": {
    "event_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 event.",
      "x-data-class": "operational"
    },
    "event_type": {
      "type": "string",
      "description": "What the event is, as the capability that emitted it declares it.",
      "x-data-class": "operational"
    },
    "replays": {
      "type": "integer",
      "description": "How many times the event's delivery has been replayed.",
      "x-data-class": "operational"
    }
  },
  "required": [
    "event_id",
    "event_type",
    "replays"
  ],
  "additionalProperties": false
}

Refusals

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: no document originates a delivery replay
  • Outbound: an operator's act; crosses to no counterparty

Events

None emitted.

Related

None.