publ Reference

photobook_comments_apply

Changes comments in the Photobook app (pApp B00005). Another app code is refused before any request. Called without confirmToken it previews and returns a confirmToken; repeating the same input with it executes once.

Inputs

Field	Required here	Contract
`postId`	Yes	integer; greater than 0
`action`	Yes	one of: `reply`, `delete`, `pin` (by `kind`)
`action.content`	Yes	When `action.kind` is `reply`: string; min length 1; max length 15000; For inquiry answers: original HTML, conservatively capped at 15,000 serialized units. Other comments: at most 3,000 units. Comments need at least one non-space character; inquiry answers need at least 2 units.
`action.source`	No	When `action.kind` is `reply`: one of: `local-file`, `more-parts`, `complete`, `cancel` (by `kind`)
`action.source.filename`	Yes	When `action.kind` is `reply` and `action.source.kind` is `local-file`: string; min length 1; max length 240; pattern `^[^/\\:\x00-\x1f\x7f]+$`; The name of the file on this computer, with its extension.
`action.source.byteLength`	Yes	When `action.kind` is `reply` and `action.source.kind` is `local-file`: integer; greater than 0; The exact file size in bytes (for example from `wc -c < FILE` or `stat`).
`action.source.sha256`	No	When `action.kind` is `reply` and `action.source.kind` is `local-file`: string; pattern `^[0-9a-f]{64}$`; The SHA-256 of the file in lowercase hex (shasum -a 256 FILE). Required when the upload answers UPLOAD_CHECKSUM_REQUIRED.
`action.source.uploadId`	Yes	When `action.kind` is `reply` and `action.source.kind` is `more-parts`: string; pattern `^upl_[A-Za-z0-9_-]{22}$`
`action.source.fromPart`	Yes	When `action.kind` is `reply` and `action.source.kind` is `more-parts`: integer; minimum 1; maximum 10000
`action.source.uploadId`	Yes	When `action.kind` is `reply` and `action.source.kind` is `complete`: string; pattern `^upl_[A-Za-z0-9_-]{22}$`
`action.source.parts`	Yes	When `action.kind` is `reply` and `action.source.kind` is `complete`: array; min items 1; max items 10000
`action.source.parts[].partNumber`	Yes	When `action.kind` is `reply` and `action.source.kind` is `complete`: integer; minimum 1; maximum 10000
`action.source.parts[].etag`	Yes	When `action.kind` is `reply` and `action.source.kind` is `complete`: string; min length 1; max length 200
`action.source.measured`	No	When `action.kind` is `reply` and `action.source.kind` is `complete`: object
`action.source.measured.durationSeconds`	Yes	When `action.kind` is `reply` and `action.source.kind` is `complete`: number; maximum 1000000; greater than 0; Video duration in seconds (ffprobe format.duration).
`action.source.measured.frameRate`	Yes	When `action.kind` is `reply` and `action.source.kind` is `complete`: number; maximum 1000; greater than 0; Frames per second (ffprobe avg_frame_rate, for example 30000/1001 = 29.97).
`action.source.measured.width`	Yes	When `action.kind` is `reply` and `action.source.kind` is `complete`: integer; maximum 100000; greater than 0
`action.source.measured.height`	Yes	When `action.kind` is `reply` and `action.source.kind` is `complete`: integer; maximum 100000; greater than 0
`action.source.measured.frameRateMode`	No	When `action.kind` is `reply` and `action.source.kind` is `complete`: `CFR`, `VFR`; Constant or variable frame rate, when the tool reports it.
`action.source.measured.minFrameRate`	No	When `action.kind` is `reply` and `action.source.kind` is `complete`: number; maximum 1000; greater than 0
`action.source.measured.maxFrameRate`	No	When `action.kind` is `reply` and `action.source.kind` is `complete`: number; maximum 1000; greater than 0
`action.source.uploadId`	Yes	When `action.kind` is `reply` and `action.source.kind` is `cancel`: string; pattern `^upl_[A-Za-z0-9_-]{22}$`
`action.commentId`	Yes	When `action.kind` is `delete`: integer; greater than 0
`action.confirmation`	Yes	When `action.kind` is `delete`: `DELETE_COMMENT`
`action.commentId`	Yes	When `action.kind` is `pin`: integer; greater than 0
`action.pinned`	Yes	When `action.kind` is `pin`: boolean
`confirmToken`	No	string; pattern `^ct[a-f\d]{32}$`; The confirmToken from this tool's preview result. Omit it to preview; repeat the same input with it to execute.