Upload track file and append

POST

/wp-json/wp2/media-subtitles-timecodes/v1/attachments/{id}/tracks/upload

curl --request POST \
  --url https://example.com/wp-json/wp2/media-subtitles-timecodes/v1/attachments/1/tracks/upload \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-WP-Nonce: <X-WP-Nonce>' \
  --form file=@file \
  --form kind=subtitles \
  --form srclang=example \
  --form label=example \
  --form default=example

Accepts a subtitle/chapter file (multipart) and appends it as a new track. Returns 201.

Authorizations

• cookie
• applicationPassword

Parameters

Path Parameters

id

required

integer

Numeric entity id.

Request Body

Media typemultipart/form-data

object

file

required

Uploaded file (multipart).

string format: binary

kind

Field “kind” as returned or accepted by PHP.

string

Allowed values: subtitles captions chapters

srclang

Field “srclang” as returned or accepted by PHP.

string

label

Product label.

string

default

Field “default” as returned or accepted by PHP.

string

Responses

201

Media typeapplication/json

object

kind

Field “kind” as returned or accepted by PHP.

string

Allowed values: subtitles captions chapters

src

Dynamic Shortcode island source.

string format: uri

srclang

Field “srclang” as returned or accepted by PHP.

string

label

Product label.

string

default

Field “default” as returned or accepted by PHP.

string

Example

{
  "kind": "subtitles"
}

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": {}
}