publ Reference

timeline_comments_apply

Changes comments in the Timeline app (pApp A00001, or an instance code of the same family). 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
`instanceCode`	No	string; pattern `^A(?:000\|9[0-9]{2})01$`; Optional: which installed Timeline app to use (its code, such as A00001 or A90101). Omit it when only one is installed; when several are, pick one from the installed list.
`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.