List playback artifacts under media-playback/attachments/{id}

GET

/wp-json/wp2/media-converter/v1/attachments/{id}/artifacts

curl --request GET \
  --url https://example.com/wp-json/wp2/media-converter/v1/attachments/1/artifacts \
  --header 'X-WP-Nonce: <X-WP-Nonce>'

Lists playback artifact folders (sources, subtitles, chapters, thumbnails, stills) already bound to the video attachment. Upload the original video via core POST /wp/v2/media. PlayerJS skins are not part of this API.

Authorizations

• cookie
• applicationPassword

Parameters

Path Parameters

id

required

integer

Numeric entity id.

Responses

200

On-disk artifacts listing and format map.

Media typeapplication/json

object

attachment_id

Video attachment ID.

integer

basename

Movie basename without extension.

string

sources

Files in the sources folder (HLS/MP4, etc.).

Array<object>

object

name

File name relative to the artifacts folder.

string

url

Public file URL.

string

bytes

File size in bytes.

integer

subtitles

Subtitle files on disk.

Array<object>

object

name

File name relative to the artifacts folder.

string

url

Public file URL.

string

bytes

File size in bytes.

integer

chapters

Chapter files on disk.

Array<object>

object

name

File name relative to the artifacts folder.

string

url

Public file URL.

string

bytes

File size in bytes.

integer

thumbnails

Seekbar sprite/VTT files.

Array<object>

object

name

File name relative to the artifacts folder.

string

url

Public file URL.

string

bytes

File size in bytes.

integer

stills

Still frames (*_thumbN.jpg).

Array<object>

object

name

File name relative to the artifacts folder.

string

url

Public file URL.

string

bytes

File size in bytes.

integer

formats

Map of format key → exists/url.

object

key

additional properties

object

exists

True if this format file already exists on disk.

boolean

url

Format file URL, or an empty string.

string

poster

Poster URL from attachment meta (may be empty).

string

Example^generated

{
  "attachment_id": 1,
  "basename": "example",
  "sources": [
    {
      "name": "example",
      "url": "example",
      "bytes": 1
    }
  ],
  "subtitles": [
    {
      "name": "example",
      "url": "example",
      "bytes": 1
    }
  ],
  "chapters": [
    {
      "name": "example",
      "url": "example",
      "bytes": 1
    }
  ],
  "thumbnails": [
    {
      "name": "example",
      "url": "example",
      "bytes": 1
    }
  ],
  "stills": [
    {
      "name": "example",
      "url": "example",
      "bytes": 1
    }
  ],
  "formats": {
    "additionalProperty": {
      "exists": true,
      "url": "example"
    }
  },
  "poster": "example"
}

400

Not a video attachment

Media typeapplication/json

object

code

Machine-readable error or event code.

string

message

Message text (log, PIN, or password reset).

string

data

Extra WP_Error or license payload.

object

Example^generated

{
  "code": "example",
  "message": "example",
  "data": {}
}

401

Not authenticated. WordPress REST: rest_not_logged_in / rest_forbidden. Use cookie + X-WP-Nonce or Application Password.

Media typeapplication/json

object

code

Machine-readable error or event code.

string

message

Message text (log, PIN, or password reset).

string

data

Extra WP_Error or license payload.

object

Example^generated

{
  "code": "example",
  "message": "example",
  "data": {}
}

403

Insufficient capability or invalid REST nonce. WordPress REST: rest_forbidden / rest_cookie_invalid_nonce.

Media typeapplication/json

object

code

Machine-readable error or event code.

string

message

Message text (log, PIN, or password reset).

string

data

Extra WP_Error or license payload.

object

Example^generated

{
  "code": "example",
  "message": "example",
  "data": {}
}

404

Attachment not found

Media typeapplication/json

object

code

Machine-readable error or event code.

string

message

Message text (log, PIN, or password reset).

string

data

Extra WP_Error or license payload.

object

Example^generated

{
  "code": "example",
  "message": "example",
  "data": {}
}