acknowledge_push · Open a push · Container Trade HQ API

Contract

shape: entity
authority: act
evidence: none
subscription: false
permission: any one of: self.act (the signed-in caller, about themself only; it names no other user); a deactivated caller is refused first
idempotency: natural
emits: none
MCP tool: none
decision_set: approve, reject
REST: POST https://api.containertradehq.com/v1/cap/acknowledge_push

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

Inputs

name	type	required	validation
push_id	uuid	required	UUID The push, as its deep link names it.

Response

push_id · string · The push.
source_kind · string · What it was about.
source_id · string · The event's or the exception's id.
event_type · string · The event's type, or exception.raised.

Full JSON Schema

{
  "type": "object",
  "properties": {
    "push_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 push.",
      "x-data-class": "operational"
    },
    "source_kind": {
      "type": "string",
      "enum": [
        "capability_event",
        "exception"
      ],
      "description": "What it was about.",
      "x-data-class": "operational"
    },
    "source_id": {
      "type": "string",
      "description": "The event's or the exception's id.",
      "x-data-class": "operational"
    },
    "event_type": {
      "type": "string",
      "description": "The event's type, or exception.raised.",
      "x-data-class": "operational"
    }
  },
  "required": [
    "push_id",
    "source_kind",
    "source_id",
    "event_type"
  ],
  "additionalProperties": false
}

Refusals

push_not_found · 422 · no push sent to the caller has that id; another user's gets the same answer

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

Surfaces

DesktopN

MobileF

APIF

MCPN

VoiceD2

PushN

OneBoxN

OutboundN

Desktop: a push is opened on the device it reached
MCP: a push reaches a device, never an agent
Voice: degraded: confirmation
Push: emits nothing
OneBox: no document originates a push
Outbound: crosses to no counterparty

Events

None emitted.

None.