Replace all tracks

PUT

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

curl --request PUT \
  --url https://example.com/wp-json/wp2/media-subtitles-timecodes/v1/attachments/1/tracks \
  --header 'Content-Type: application/json' \
  --header 'X-WP-Nonce: <X-WP-Nonce>' \
  --data '{ "tracks": [ { "kind": "subtitles", "src": "https://example.com", "srclang": "example", "label": "example", "default": "example" } ] }'

Replaces the whole track set with the tracks array. Tracks omitted from the body are removed.

Authorizations

• cookie
• applicationPassword

Parameters

Path Parameters

id

required

integer

Numeric entity id.

Request Body

Media typeapplication/json

object

tracks

required

Subtitle/chapter tracks array.

Array<object>

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

Responses

200

Media typeapplication/json

object

attachment_id

Media library attachment ID.

integer

tracks

Subtitle/chapter tracks array.

Array<object>

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

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