opbox

The webcapture.* family (2 verbs). Every verb enters through the one front door: it is capability-checked, permission-checked, scope-checked and audited before it runs (see Security & permissions). Each entry below lists its capability, risk class (which fixes the minimum autonomy level), the minimum caller permission, its availability tier, whether it is idempotent, and any outbound egress.

Createwebcapture.record.create

PropertyValue
Capabilityother.write
Risk classWrite - autonomy L1
Min. permissionMember
AvailabilityOn demand (MCP tier 2)
IdempotentNo
EgressNone - in-box (pure Postgres, no outbound call)

Mint a web_capture_records row for a matter (fence in workspace). status defaults REQUESTED. requested_by_id = OPTIONAL requestedById (guarded) else the acting user (NULL for a seat). No updated_at column.

Call POST /v/webcapture.record.create with a JSON body; returns JSON (or { error, code }). Also exposed as the MCP tool webcapture.record.create.

Updatewebcapture.record.update

PropertyValue
Capabilityother.write
Risk classWrite - autonomy L1
Min. permissionMember
AvailabilityOn demand (MCP tier 2)
IdempotentNo
EgressNone - in-box (pure Postgres, no outbound call)

Partial PATCH by id + workspace fence (status/capturedAt/ failedReason/fileRecordId; the writeback leg sets COMPLETED+capturedAt+fileRecordId). No updated_at column.

Call POST /v/webcapture.record.update with a JSON body; returns JSON (or { error, code }). Also exposed as the MCP tool webcapture.record.update.