board_appearance_apply
Changes appearance editor in the Free Board app (pApp A00003, 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 |
|---|---|---|
settings |
Yes | When alternative 1: object |
instanceCode |
No | When alternative 1: string; pattern ^A(?:000|9[0-9]{2})03$; Optional: which installed Free Board app to use (its code, such as A00003 or A90103). Omit it when only one is installed; when several are, pick one from the installed list. |
confirmToken |
No | When alternative 1: 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. |
restoreFromTaskId |
Yes | When alternative 2: string; pattern ^[A-Za-z0-9_-]{8,80}$ |
restoreSettings |
No | When alternative 2: array; items: string; min items 1; max items 30 |
instanceCode |
No | When alternative 2: string; pattern ^A(?:000|9[0-9]{2})03$; Optional: which installed Free Board app to use (its code, such as A00003 or A90103). Omit it when only one is installed; when several are, pick one from the installed list. |
confirmToken |
No | When alternative 2: 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. |
action |
Yes | When alternative 3: one of: posts_hero, posts_hero, posts_hero (by kind) |
action.field |
Yes | When alternative 3 and action.kind is posts_hero: title |
action.value |
Yes | When alternative 3 and action.kind is posts_hero: string; min length 0; max length 20 |
action.field |
Yes | When alternative 3 and action.kind is posts_hero: description |
action.value |
Yes | When alternative 3 and action.kind is posts_hero: string; min length 0; max length 40 |
action.field |
Yes | When alternative 3 and action.kind is posts_hero: resourceSrc |
action.source |
Yes | When alternative 3 and action.kind is posts_hero: one of: local-file, more-parts, complete, cancel (by kind) |
action.source.filename |
Yes | When alternative 3 and action.kind is posts_hero 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 alternative 3 and action.kind is posts_hero 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 alternative 3 and action.kind is posts_hero 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 alternative 3 and action.kind is posts_hero and action.source.kind is more-parts: string; pattern ^upl_[A-Za-z0-9_-]{22}$ |
action.source.fromPart |
Yes | When alternative 3 and action.kind is posts_hero and action.source.kind is more-parts: integer; minimum 1; maximum 10000 |
action.source.uploadId |
Yes | When alternative 3 and action.kind is posts_hero and action.source.kind is complete: string; pattern ^upl_[A-Za-z0-9_-]{22}$ |
action.source.parts |
Yes | When alternative 3 and action.kind is posts_hero and action.source.kind is complete: array; min items 1; max items 10000 |
action.source.parts[].partNumber |
Yes | When alternative 3 and action.kind is posts_hero and action.source.kind is complete: integer; minimum 1; maximum 10000 |
action.source.parts[].etag |
Yes | When alternative 3 and action.kind is posts_hero and action.source.kind is complete: string; min length 1; max length 200 |
action.source.measured |
No | When alternative 3 and action.kind is posts_hero and action.source.kind is complete: object |
action.source.measured.durationSeconds |
Yes | When alternative 3 and action.kind is posts_hero 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 alternative 3 and action.kind is posts_hero 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 alternative 3 and action.kind is posts_hero and action.source.kind is complete: integer; maximum 100000; greater than 0 |
action.source.measured.height |
Yes | When alternative 3 and action.kind is posts_hero and action.source.kind is complete: integer; maximum 100000; greater than 0 |
action.source.measured.frameRateMode |
No | When alternative 3 and action.kind is posts_hero and action.source.kind is complete: CFR, VFR; Constant or variable frame rate, when the tool reports it. |
action.source.measured.minFrameRate |
No | When alternative 3 and action.kind is posts_hero and action.source.kind is complete: number; maximum 1000; greater than 0 |
action.source.measured.maxFrameRate |
No | When alternative 3 and action.kind is posts_hero and action.source.kind is complete: number; maximum 1000; greater than 0 |
action.source.uploadId |
Yes | When alternative 3 and action.kind is posts_hero and action.source.kind is cancel: string; pattern ^upl_[A-Za-z0-9_-]{22}$ |
instanceCode |
No | When alternative 3: string; pattern ^A(?:000|9[0-9]{2})03$; Optional: which installed Free Board app to use (its code, such as A00003 or A90103). Omit it when only one is installed; when several are, pick one from the installed list. |
confirmToken |
No | When alternative 3: 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. |