Multipart upload into one artifacts folder
const url = 'https://example.com/wp-json/wp2/media-converter/v1/attachments/1/artifacts/sources';const form = new FormData();form.append('files', 'file');form.append('file', 'file');form.append('srclang', 'example');form.append('label', 'example');form.append('default', 'example');
const options = {method: 'PUT', headers: {'X-WP-Nonce': '<X-WP-Nonce>'}};
options.body = form;
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request PUT \ --url https://example.com/wp-json/wp2/media-converter/v1/attachments/1/artifacts/sources \ --header 'Content-Type: multipart/form-data' \ --header 'X-WP-Nonce: <X-WP-Nonce>' \ --form files=@file \ --form file=@file \ --form srclang=example \ --form label=example \ --form default=exampleUploads multipart files into one artifacts folder: sources, subtitles, chapters, thumbnails, or stills.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Numeric entity id.
Artifacts folder: sources, subtitles, chapters, thumbnails, stills.
Request Bodyrequired
Section titled “Request Bodyrequired”object
Map of relative paths to file contents (strings).
Uploaded file (multipart).
Field “srclang” as returned or accepted by PHP.
Product label.
Field “default” as returned or accepted by PHP.
Responses
Section titled “Responses”Listing after folder upload, plus accepted/rejected.
object
Video attachment ID.
Movie basename without extension.
Files in the sources folder (HLS/MP4, etc.).
object
File name relative to the artifacts folder.
Public file URL.
File size in bytes.
Subtitle files on disk.
object
File name relative to the artifacts folder.
Public file URL.
File size in bytes.
Chapter files on disk.
object
File name relative to the artifacts folder.
Public file URL.
File size in bytes.
Seekbar sprite/VTT files.
object
File name relative to the artifacts folder.
Public file URL.
File size in bytes.
Still frames (*_thumbN.jpg).
object
File name relative to the artifacts folder.
Public file URL.
File size in bytes.
Map of format key → exists/url.
object
object
True if this format file already exists on disk.
Format file URL, or an empty string.
Poster URL from attachment meta (may be empty).
Files PHP stored.
object
Relative path in the request or ZIP.
Rejection code (rejected items) or reason.
File-save error message.
Accepted file name.
Accepted file URL.
Files PHP rejected (name, size, HLS limit).
object
Relative path in the request or ZIP.
Rejection code (rejected items) or reason.
File-save error message.
Accepted file name.
Accepted file URL.
ZIP pack mode (pack only).
Folders the pack actually changed.
Example
{ "mode": "replace"}Validation failed (including hls_segment_too_large)
object
Machine-readable error or event code.
Message text (log, PIN, or password reset).
Extra WP_Error or license payload.
object
Examplegenerated
{ "code": "example", "message": "example", "data": {}}Not authenticated. WordPress REST: rest_not_logged_in / rest_forbidden. Use cookie + X-WP-Nonce or Application Password.
object
Machine-readable error or event code.
Message text (log, PIN, or password reset).
Extra WP_Error or license payload.
object
Examplegenerated
{ "code": "example", "message": "example", "data": {}}Insufficient capability or invalid REST nonce. WordPress REST: rest_forbidden / rest_cookie_invalid_nonce.
object
Machine-readable error or event code.
Message text (log, PIN, or password reset).
Extra WP_Error or license payload.
object
Examplegenerated
{ "code": "example", "message": "example", "data": {}}