Update site status

PATCH

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

curl --request PATCH \
  --url https://example.com/wp-json/wp2/site-manager/v1/statuses/1 \
  --header 'Content-Type: application/json' \
  --header 'X-WP-Nonce: <X-WP-Nonce>' \
  --data '{ "name": "In progress" }'

Partially updates the status term: name and/or slug. Empty body — return the current term. Requires manage_network.

Authorizations

• cookie
• applicationPassword

Parameters

Path Parameters

id

required

integer

Site Manager status term_id.

Request Body

Media typeapplication/json

object

name

New name. Missing key — leave unchanged.

string

slug

New slug (sanitize_title). Missing key — leave unchanged.

string

Example

{
  "name": "In progress"
}

Responses

200

Status after update.

Media typeapplication/json

object

id

Site Manager status term_id (not WP_Site->public and not a post status).

integer

name

Status display name. The list may rewrite default labels.

string

slug

Status term slug (sanitize_title on write).

string

Example

{
  "id": 12,
  "name": "In progress",
  "slug": "in-progress"
}

400

wp_update_term WP_Error other than term_exists.

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

401

Not authenticated. DualRest: rest_forbidden (status 401) when there is no cookie session. 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

Missing manage_network or invalid REST 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": {}
}

404

Term_not_found — no such status term.

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

409

Term_exists — name/slug conflict.

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