Обновить категорию сайтов

PATCH

/wp-json/wp2/site-manager/v1/categories/{id}

curl --request PATCH \
  --url https://example.com/wp-json/wp2/site-manager/v1/categories/1 \
  --header 'Content-Type: application/json' \
  --header 'X-WP-Nonce: <X-WP-Nonce>' \
  --data '{ "name": "Учебные проекты" }'

Частично обновляет термин категории: name, slug, parent_id. Пустое тело — вернуть текущий термин без записи. Нужно manage_network.

Authorizations

• cookie
• applicationPassword

Parameters

Path Parameters

id

required

integer

Term_id категории Site Manager.

Request Body

Media typeapplication/json

object

name

Новое имя. Отсутствие ключа — не менять.

string

slug

Новый ярлык (sanitize_title). Отсутствие ключа — не менять.

string

parent_id

Новый родитель. Ключ должен быть передан, чтобы PHP сменил parent (в т.ч. на 0).

integer

Example

{
  "name": "Учебные проекты"
}

Responses

200

Категория после обновления.

Media typeapplication/json

object

id

Term_id категории сайтов (таксономия Site Manager, не рубрика записей).

integer

name

Отображаемое имя термина. В списке PHP может подменить дефолтные ярлыки через translate_default_term_label.

string

slug

Ярлык термина категории (sanitize_title при записи).

string

parent

Term_id родителя (WP_Term->parent); 0 — корень. В SiteDto.categories PHP это поле не кладёт.

integer

Example

{
  "id": 3,
  "name": "Учебные проекты",
  "slug": "training",
  "parent": 0
}

400

WP_Error wp_update_term без term_exists.

Media typeapplication/json

object

code

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

string

message

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

string

data

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

object

Example^generated

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

401

Не аутентифицирован. DualRest: rest_forbidden (status 401), если нет cookie-сессии. 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

Нет права manage_network или невалидный REST nonce.

Media typeapplication/json

object

code

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

string

message

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

string

data

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

object

Example^generated

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

404

Term_not_found — нет такого термина категории.

Media typeapplication/json

object

code

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

string

message

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

string

data

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

object

Example^generated

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

409

Term_exists — конфликт имени/ярлыка.

Media typeapplication/json

object

code

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

string

message

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

string

data

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

object

Example^generated

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