Заменить файл вложения с сохранением идентификатора

POST

/wp-json/wp2/enable-media-replace/v1/attachments/{id}/replace

curl --request POST \
  --url https://example.com/wp-json/wp2/enable-media-replace/v1/attachments/1/replace \
  --header 'Content-Type: multipart/form-data' \
  --header 'X-WP-Nonce: <X-WP-Nonce>' \
  --form file=@file \
  --form mode=replace \
  --form time_mode=update_all \
  --form custom_date=example \
  --form new_filename=example \
  --form location_dir=example

Заменяет байты файла вложения, ID в медиатеке тот же. Если есть артефакты media-playback — 409: сначала их снимают. Multipart file и режим замены.

Authorizations

• cookie
• applicationPassword

Parameters

Path Parameters

id

required

integer

Числовой идентификатор сущности.

Request Body

Media typemultipart/form-data

object

file

required

Загружаемый файл (multipart).

string format: binary

mode

Режим (подключения, replace, pack).

string

Allowed values: replace replace_and_search

time_mode

Поле «time_mode», как принимает или отдаёт PHP.

string

Allowed values: update_all update_modified custom

custom_date

Поле «custom_date», как принимает или отдаёт PHP.

string

new_filename

Поле «new_filename», как принимает или отдаёт PHP.

string

location_dir

Поле «location_dir», как принимает или отдаёт PHP.

string

Responses

200

Media typeapplication/json

object

attachment_id

ID вложения медиатеки.

integer

url

URL.

string

mode

Режим (подключения, replace, pack).

string

filename

Поле «filename», как принимает или отдаёт PHP.

string

mime_type

Поле «mime_type», как принимает или отдаёт PHP.

string

Example^generated

{
  "attachment_id": 1,
  "url": "example",
  "mode": "example",
  "filename": "example",
  "mime_type": "example"
}

401

Не аутентифицирован. WordPress REST: rest_not_logged_in / rest_forbidden. Cookie + X-WP-Nonce или Application Password.

Media typeapplication/json

object

code

Машинный код ошибки или события.

string

message

Текст сообщения (лог, PIN, сброс пароля).

string

data

Дополнительные данные WP_Error или лицензии.

object

Example^generated

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

403

Нет права или невалидный REST nonce. WordPress REST: rest_forbidden / rest_cookie_invalid_nonce.

Media typeapplication/json

object

code

Машинный код ошибки или события.

string

message

Текст сообщения (лог, PIN, сброс пароля).

string

data

Дополнительные данные WP_Error или лицензии.

object

Example^generated

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