publ betaReference (MCP guide)
Open publ console

publ Reference

article_files_upload

Uploads files for file upload in the Article app (pApp B00001, 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
purpose Yes one of: post_thumbnail, post_cover, series_thumbnail, series_cover, board_cover, article_hero_image, article_inline_image, article_conversion_thumbnail, article_post_editor_image, article_series_thumbnail, article_series_cover, article_category_cover, article_home_image, article_home_image, article_home_image, article_home_image
upload Yes When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover: one of: local-file, more-parts, complete, cancel (by kind)
upload.filename Yes When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover and upload.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.
upload.byteLength Yes When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover and upload.kind is local-file: integer; greater than 0; The exact file size in bytes (for example from wc -c < FILE or stat).
upload.sha256 No When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover and upload.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.
upload.uploadId Yes When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover and upload.kind is more-parts: string; pattern ^upl_[A-Za-z0-9_-]{22}$
upload.fromPart Yes When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover and upload.kind is more-parts: integer; minimum 1; maximum 10000
upload.uploadId Yes When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover and upload.kind is complete: string; pattern ^upl_[A-Za-z0-9_-]{22}$
upload.parts Yes When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover and upload.kind is complete: array; min items 1; max items 10000
upload.parts[].partNumber Yes When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover and upload.kind is complete: integer; minimum 1; maximum 10000
upload.parts[].etag Yes When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover and upload.kind is complete: string; min length 1; max length 200
upload.measured No When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover and upload.kind is complete: object
upload.measured.durationSeconds Yes When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover and upload.kind is complete: number; maximum 1000000; greater than 0; Video duration in seconds (ffprobe format.duration).
upload.measured.frameRate Yes When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover and upload.kind is complete: number; maximum 1000; greater than 0; Frames per second (ffprobe avg_frame_rate, for example 30000/1001 = 29.97).
upload.measured.width Yes When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover and upload.kind is complete: integer; maximum 100000; greater than 0
upload.measured.height Yes When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover and upload.kind is complete: integer; maximum 100000; greater than 0
upload.measured.frameRateMode No When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover and upload.kind is complete: CFR, VFR; Constant or variable frame rate, when the tool reports it.
upload.measured.minFrameRate No When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover and upload.kind is complete: number; maximum 1000; greater than 0
upload.measured.maxFrameRate No When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover and upload.kind is complete: number; maximum 1000; greater than 0
upload.uploadId Yes When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover and upload.kind is cancel: string; pattern ^upl_[A-Za-z0-9_-]{22}$
instanceCode No When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover: string; pattern ^B(?:000|9[0-9]{2})01$; Optional: which installed Article app to use (its code, such as B00001 or B90101). Omit it when only one is installed; when several are, pick one from the installed list.
confirmToken No When purpose is post_thumbnail or post_cover or series_thumbnail or series_cover or board_cover or article_hero_image or article_inline_image or article_conversion_thumbnail or article_post_editor_image or article_series_thumbnail or article_series_cover or article_category_cover: 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.
sectionId Yes When purpose is article_home_image: integer; greater than 0
itemId Yes When purpose is article_home_image: integer; greater than 0
field Yes When purpose is article_home_image: alternativeLogoSrc
upload Yes When purpose is article_home_image: one of: local-file, more-parts, complete, cancel (by kind)
upload.filename Yes When purpose is article_home_image and upload.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.
upload.byteLength Yes When purpose is article_home_image and upload.kind is local-file: integer; greater than 0; The exact file size in bytes (for example from wc -c < FILE or stat).
upload.sha256 No When purpose is article_home_image and upload.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.
upload.uploadId Yes When purpose is article_home_image and upload.kind is more-parts: string; pattern ^upl_[A-Za-z0-9_-]{22}$
upload.fromPart Yes When purpose is article_home_image and upload.kind is more-parts: integer; minimum 1; maximum 10000
upload.uploadId Yes When purpose is article_home_image and upload.kind is complete: string; pattern ^upl_[A-Za-z0-9_-]{22}$
upload.parts Yes When purpose is article_home_image and upload.kind is complete: array; min items 1; max items 10000
upload.parts[].partNumber Yes When purpose is article_home_image and upload.kind is complete: integer; minimum 1; maximum 10000
upload.parts[].etag Yes When purpose is article_home_image and upload.kind is complete: string; min length 1; max length 200
upload.measured No When purpose is article_home_image and upload.kind is complete: object
upload.measured.durationSeconds Yes When purpose is article_home_image and upload.kind is complete: number; maximum 1000000; greater than 0; Video duration in seconds (ffprobe format.duration).
upload.measured.frameRate Yes When purpose is article_home_image and upload.kind is complete: number; maximum 1000; greater than 0; Frames per second (ffprobe avg_frame_rate, for example 30000/1001 = 29.97).
upload.measured.width Yes When purpose is article_home_image and upload.kind is complete: integer; maximum 100000; greater than 0
upload.measured.height Yes When purpose is article_home_image and upload.kind is complete: integer; maximum 100000; greater than 0
upload.measured.frameRateMode No When purpose is article_home_image and upload.kind is complete: CFR, VFR; Constant or variable frame rate, when the tool reports it.
upload.measured.minFrameRate No When purpose is article_home_image and upload.kind is complete: number; maximum 1000; greater than 0
upload.measured.maxFrameRate No When purpose is article_home_image and upload.kind is complete: number; maximum 1000; greater than 0
upload.uploadId Yes When purpose is article_home_image and upload.kind is cancel: string; pattern ^upl_[A-Za-z0-9_-]{22}$
instanceCode No When purpose is article_home_image: string; pattern ^B(?:000|9[0-9]{2})01$; Optional: which installed Article app to use (its code, such as B00001 or B90101). Omit it when only one is installed; when several are, pick one from the installed list.
confirmToken No When purpose is article_home_image: 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.
sectionId Yes When purpose is article_home_image: integer; greater than 0
itemId Yes When purpose is article_home_image: integer; greater than 0
field Yes When purpose is article_home_image: backgroundDesktopImgSrc
upload Yes When purpose is article_home_image: one of: local-file, more-parts, complete, cancel (by kind)
upload.filename Yes When purpose is article_home_image and upload.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.
upload.byteLength Yes When purpose is article_home_image and upload.kind is local-file: integer; greater than 0; The exact file size in bytes (for example from wc -c < FILE or stat).
upload.sha256 No When purpose is article_home_image and upload.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.
upload.uploadId Yes When purpose is article_home_image and upload.kind is more-parts: string; pattern ^upl_[A-Za-z0-9_-]{22}$
upload.fromPart Yes When purpose is article_home_image and upload.kind is more-parts: integer; minimum 1; maximum 10000
upload.uploadId Yes When purpose is article_home_image and upload.kind is complete: string; pattern ^upl_[A-Za-z0-9_-]{22}$
upload.parts Yes When purpose is article_home_image and upload.kind is complete: array; min items 1; max items 10000
upload.parts[].partNumber Yes When purpose is article_home_image and upload.kind is complete: integer; minimum 1; maximum 10000
upload.parts[].etag Yes When purpose is article_home_image and upload.kind is complete: string; min length 1; max length 200
upload.measured No When purpose is article_home_image and upload.kind is complete: object
upload.measured.durationSeconds Yes When purpose is article_home_image and upload.kind is complete: number; maximum 1000000; greater than 0; Video duration in seconds (ffprobe format.duration).
upload.measured.frameRate Yes When purpose is article_home_image and upload.kind is complete: number; maximum 1000; greater than 0; Frames per second (ffprobe avg_frame_rate, for example 30000/1001 = 29.97).
upload.measured.width Yes When purpose is article_home_image and upload.kind is complete: integer; maximum 100000; greater than 0
upload.measured.height Yes When purpose is article_home_image and upload.kind is complete: integer; maximum 100000; greater than 0
upload.measured.frameRateMode No When purpose is article_home_image and upload.kind is complete: CFR, VFR; Constant or variable frame rate, when the tool reports it.
upload.measured.minFrameRate No When purpose is article_home_image and upload.kind is complete: number; maximum 1000; greater than 0
upload.measured.maxFrameRate No When purpose is article_home_image and upload.kind is complete: number; maximum 1000; greater than 0
upload.uploadId Yes When purpose is article_home_image and upload.kind is cancel: string; pattern ^upl_[A-Za-z0-9_-]{22}$
instanceCode No When purpose is article_home_image: string; pattern ^B(?:000|9[0-9]{2})01$; Optional: which installed Article app to use (its code, such as B00001 or B90101). Omit it when only one is installed; when several are, pick one from the installed list.
confirmToken No When purpose is article_home_image: 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.
sectionId Yes When purpose is article_home_image: integer; greater than 0
itemId Yes When purpose is article_home_image: integer; greater than 0
field Yes When purpose is article_home_image: backgroundMobileImgSrc
upload Yes When purpose is article_home_image: one of: local-file, more-parts, complete, cancel (by kind)
upload.filename Yes When purpose is article_home_image and upload.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.
upload.byteLength Yes When purpose is article_home_image and upload.kind is local-file: integer; greater than 0; The exact file size in bytes (for example from wc -c < FILE or stat).
upload.sha256 No When purpose is article_home_image and upload.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.
upload.uploadId Yes When purpose is article_home_image and upload.kind is more-parts: string; pattern ^upl_[A-Za-z0-9_-]{22}$
upload.fromPart Yes When purpose is article_home_image and upload.kind is more-parts: integer; minimum 1; maximum 10000
upload.uploadId Yes When purpose is article_home_image and upload.kind is complete: string; pattern ^upl_[A-Za-z0-9_-]{22}$
upload.parts Yes When purpose is article_home_image and upload.kind is complete: array; min items 1; max items 10000
upload.parts[].partNumber Yes When purpose is article_home_image and upload.kind is complete: integer; minimum 1; maximum 10000
upload.parts[].etag Yes When purpose is article_home_image and upload.kind is complete: string; min length 1; max length 200
upload.measured No When purpose is article_home_image and upload.kind is complete: object
upload.measured.durationSeconds Yes When purpose is article_home_image and upload.kind is complete: number; maximum 1000000; greater than 0; Video duration in seconds (ffprobe format.duration).
upload.measured.frameRate Yes When purpose is article_home_image and upload.kind is complete: number; maximum 1000; greater than 0; Frames per second (ffprobe avg_frame_rate, for example 30000/1001 = 29.97).
upload.measured.width Yes When purpose is article_home_image and upload.kind is complete: integer; maximum 100000; greater than 0
upload.measured.height Yes When purpose is article_home_image and upload.kind is complete: integer; maximum 100000; greater than 0
upload.measured.frameRateMode No When purpose is article_home_image and upload.kind is complete: CFR, VFR; Constant or variable frame rate, when the tool reports it.
upload.measured.minFrameRate No When purpose is article_home_image and upload.kind is complete: number; maximum 1000; greater than 0
upload.measured.maxFrameRate No When purpose is article_home_image and upload.kind is complete: number; maximum 1000; greater than 0
upload.uploadId Yes When purpose is article_home_image and upload.kind is cancel: string; pattern ^upl_[A-Za-z0-9_-]{22}$
instanceCode No When purpose is article_home_image: string; pattern ^B(?:000|9[0-9]{2})01$; Optional: which installed Article app to use (its code, such as B00001 or B90101). Omit it when only one is installed; when several are, pick one from the installed list.
confirmToken No When purpose is article_home_image: 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.
sectionId Yes When purpose is article_home_image: integer; greater than 0
itemId Yes When purpose is article_home_image: integer; greater than 0
field Yes When purpose is article_home_image: bannerImgSrc
upload Yes When purpose is article_home_image: one of: local-file, more-parts, complete, cancel (by kind)
upload.filename Yes When purpose is article_home_image and upload.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.
upload.byteLength Yes When purpose is article_home_image and upload.kind is local-file: integer; greater than 0; The exact file size in bytes (for example from wc -c < FILE or stat).
upload.sha256 No When purpose is article_home_image and upload.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.
upload.uploadId Yes When purpose is article_home_image and upload.kind is more-parts: string; pattern ^upl_[A-Za-z0-9_-]{22}$
upload.fromPart Yes When purpose is article_home_image and upload.kind is more-parts: integer; minimum 1; maximum 10000
upload.uploadId Yes When purpose is article_home_image and upload.kind is complete: string; pattern ^upl_[A-Za-z0-9_-]{22}$
upload.parts Yes When purpose is article_home_image and upload.kind is complete: array; min items 1; max items 10000
upload.parts[].partNumber Yes When purpose is article_home_image and upload.kind is complete: integer; minimum 1; maximum 10000
upload.parts[].etag Yes When purpose is article_home_image and upload.kind is complete: string; min length 1; max length 200
upload.measured No When purpose is article_home_image and upload.kind is complete: object
upload.measured.durationSeconds Yes When purpose is article_home_image and upload.kind is complete: number; maximum 1000000; greater than 0; Video duration in seconds (ffprobe format.duration).
upload.measured.frameRate Yes When purpose is article_home_image and upload.kind is complete: number; maximum 1000; greater than 0; Frames per second (ffprobe avg_frame_rate, for example 30000/1001 = 29.97).
upload.measured.width Yes When purpose is article_home_image and upload.kind is complete: integer; maximum 100000; greater than 0
upload.measured.height Yes When purpose is article_home_image and upload.kind is complete: integer; maximum 100000; greater than 0
upload.measured.frameRateMode No When purpose is article_home_image and upload.kind is complete: CFR, VFR; Constant or variable frame rate, when the tool reports it.
upload.measured.minFrameRate No When purpose is article_home_image and upload.kind is complete: number; maximum 1000; greater than 0
upload.measured.maxFrameRate No When purpose is article_home_image and upload.kind is complete: number; maximum 1000; greater than 0
upload.uploadId Yes When purpose is article_home_image and upload.kind is cancel: string; pattern ^upl_[A-Za-z0-9_-]{22}$
instanceCode No When purpose is article_home_image: string; pattern ^B(?:000|9[0-9]{2})01$; Optional: which installed Article app to use (its code, such as B00001 or B90101). Omit it when only one is installed; when several are, pick one from the installed list.
confirmToken No When purpose is article_home_image: 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.