Command · Update Redaction

redaction.update

Changes a redaction: only the fields given.

• v1
• Capability EditProject
• Tool redaction_update

Request

{
  "command": "redaction.update",
  "params": {
    "color": [
      0,
      0,
      0
    ],
    "redaction": 3,
    "style": "solid"
  }
}

Parameters

audio`none` | `mute` | `bleep`

What happens to its sound. Default none.

clipinteger | object (1..)

Or mark through a clip: its media, between "in" and "out". A clip id, or {"track", "time"} for the clip there.

colorarray

Solid: [r, g, b], 0..1.

enabledboolean

On or off.

ininteger | string

Sequence time inside the clip where the marked range starts. Timecode in the sequence's rate ("00:01:02:03") or ticks.

mediainteger | string

The media item (id or exact name).

namestring

e.g. "Licence plate".

outinteger | string

Sequence time inside the clip where it ends. Timecode in the sequence's rate ("00:01:02:03") or ticks.

redactioninteger (1..)Required

The redaction id.

regionobject

The area: {"x", "y", "width", "height", "shape": "rectangle"|"ellipse", "feather"} (0..1 of the frame), or mask fields {"shape", "params", "path", "pathKeys"} (key times are media times). Default a centred ellipse.

sequenceinteger (1..)

Sequence id; only needed when the project has several.

sourceobject

{"start", "end"}: the media time it covers (ticks, or a timecode).

strengthnumber (0.0..1.0)

Blur radius or mosaic cell in frame heights. Default 0.05.

style`blur` | `mosaic` | `solid`

Default blur.

wordsarray

Only these media time ranges are muted or bleeped (transcript words): [{"start", "end"}].

Discussion

Run it with wabcut-cli cmd <project> --json, from an MCP client as redaction_update, or from an extension. See Edit commands for requests, references and results.