Частично обновить метаданные сайта

PATCH

/wp-json/wp2/site-manager/v1/sites/{blog_id}

curl --request PATCH \
  --url https://example.com/wp-json/wp2/site-manager/v1/sites/1 \
  --header 'Content-Type: application/json' \
  --header 'X-WP-Nonce: <X-WP-Nonce>' \
  --data '{ "title": "Учебный проект", "status_id": 12, "category_ids": [ 3 ] }'

Частичный PATCH: меняются только переданные ключи (title/slug/description/status_id/category_ids/archived/public/is_template). Контент сайта не копируется. Смена slug главного сайта — 403 main_site_slug_forbidden. archive/public на главном сайте — 403 main_site_forbidden. Занятый адрес — 409 slug_conflict.

Authorizations

• cookie
• applicationPassword

Parameters

Path Parameters

blog_id

required

integer

ID сайта в текущей сети (WP_Site->blog_id). Сайт из другой сети — 404 site_not_in_network.

Request Body

Media typeapplication/json

object

title

Новый blogname. Необязательно; отсутствие ключа — не менять. PHP делает sanitize_text_field и пишет опцию блога плюс site meta blogname.

string

slug

Новый адресный ярлык. Необязательно. PHP нормализует и через domain_exists проверяет занятость; чужой сайт с тем же domain+path — 409 slug_conflict. Главный сайт сети — 403 main_site_slug_forbidden.

string

description

Новый blogdescription. Необязательно; PHP пишет sanitize_text_field в опцию блога.

string

status_id

ID статуса Site Manager или null, чтобы снять статус. Ключ должен быть передан (array_key_exists): иначе PHP статус не трогает. Несуществующий термин — 400 invalid_term.

integer

nullable

category_ids

Полный набор ID категорий сайта. Если ключ передан (даже пустой массив) — PHP перезаписывает meta. Каждый id должен быть термином категорий; иначе 400 invalid_term.

Array<integer>

archived

True — update_blog_status(..., archived, 1); false — снять архив. Главный сайт — 403 main_site_forbidden. Не путать с integer-флагом в SiteDto.

boolean

public

1 — активировать сайт (WP_Site->public=1); иначе деактивировать (0). Главный сайт — 403 main_site_forbidden.

integer

is_template

Пишет site meta wp2platform_site_manager_is_template (1 или 0). Нужен ключ в JSON, иначе PHP флаг не меняет.

boolean

Example

{
  "title": "Учебный проект",
  "status_id": 12,
  "category_ids": [
    3
  ]
}

Responses

200

Сайт после применения патча (SiteMetadata::to_array).

Media typeapplication/json

object

blog_id

ID сайта в текущей сети (WP_Site->blog_id). Path {blog_id} тех же ручек — то же число.

integer

network_id

ID сети, которой принадлежит сайт (WP_Site->site_id). Это не blog_id и не CreateNetworkRequest.domain.

integer

title

Заголовок сайта — опция блога blogname (get_option на этом сайте). Не опция сети site_name.

string

slug

Адресный ярлык сайта. При SUBDOMAIN_INSTALL — поддомен относительно domain сети; иначе сегмент WP_Site->path без слэшей. PHP считает его в SiteSlugService::derive_slug_from_site.

string

domain

Хост сайта в таблице блогов (WP_Site->domain), без схемы https://.

string

path

Путь сайта в таблице блогов (WP_Site->path) со слэшами (часто / при поддоменах или /training/ при subdirectory). Это не путь файла Local Sync.

string

description

Подзаголовок сайта — опция блога blogdescription.

string

status_id

ID термина таксономии статусов Site Manager (site meta wp2platform_site_status). null, если статус не задан или id=0.

integer

nullable

status

Развёрнутый термин статуса Site Manager. null, если статус не задан. Не путать с флагом WP_Site->public.

object

id

Term_id статуса.

integer

name

Отображаемое имя статуса.

string

slug

Ярлык термина статуса (sanitize_title).

string

category_ids

ID терминов категорий Site Manager (site meta wp2platform_site_categories).

Array<integer>

categories

Развёрнутые категории сайта (id, name, slug). Во вложении SiteDto PHP не отдаёт parent.

Array<object>

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

site_url

Публичный URL сайта (get_site_url(blog_id)).

string format: uri

admin_url

URL wp-admin этого сайта (get_admin_url(blog_id)), не /wp-admin/network/.

string format: uri

registered

Дата регистрации блога (WP_Site->registered), как хранит ядро.

string format: date-time

last_updated

Дата последнего обновления блога (WP_Site->last_updated).

string format: date-time

public

Флаг WP_Site->public (1 — публичный/активный, 0 — снят с публикации). Не термин статуса Site Manager.

integer

archived

Флаг WP_Site->archived (1 — в архиве, 0 — нет).

integer

deleted

Флаг WP_Site->deleted в таблице блогов (ядро пометило сайт удалённым). Не результат DELETE этой API.

integer

spam

Флаг WP_Site->spam (1 — помечен как спам).

integer

mature

Флаг WP_Site->mature.

integer

is_main_site

True, если это главный сайт сети (is_main_site(blog_id)). Его нельзя удалить, архивировать, деактивировать или сменить ему slug через API (main_site_forbidden / main_site_slug_forbidden).

boolean

is_template

True, если site meta wp2platform_site_manager_is_template равно 1 (сайт-шаблон для дублирования).

boolean

user_count

Число пользователей на сайте (count_users()['total_users']). PHP добавляет поле, только если в query include есть подстрока stats; иначе ключа нет.

integer

Example

{
  "blog_id": 5,
  "network_id": 1,
  "title": "Учебный проект",
  "slug": "training",
  "domain": "training.example.com",
  "path": "/",
  "description": "Песочница для курса",
  "status_id": 12,
  "status": {
    "id": 12,
    "name": "В работе",
    "slug": "in-progress"
  },
  "category_ids": [
    3
  ],
  "categories": [
    {
      "id": 3,
      "name": "Учебные проекты",
      "slug": "training",
      "parent": 0
    }
  ],
  "site_url": "https://training.example.com/",
  "admin_url": "https://training.example.com/wp-admin/",
  "registered": "2024-03-01 10:15:00",
  "last_updated": "2026-09-12 18:40:11",
  "public": 1,
  "archived": 0,
  "deleted": 0,
  "spam": 0,
  "mature": 0,
  "is_main_site": false,
  "is_template": false,
  "user_count": 4
}

400

Invalid_term — неизвестный статус/категория; invalid_network — не удалось собрать domain/path.

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

Forbidden (нет права на блог), main_site_slug_forbidden, main_site_forbidden, или невалидный REST nonce.

Media typeapplication/json

object

code

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

string

message

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

string

data

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

object

Example^generated

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

404

Site_not_in_network / site_not_found.

Media typeapplication/json

object

code

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

string

message

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

string

data

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

object

Example^generated

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

409

Slug_conflict — этот slug уже занят другим сайтом сети.

Media typeapplication/json

object

code

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

string

message

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

string

data

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

object

Example^generated

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