Delete site category

DELETE

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

curl --request DELETE \
  --url https://example.com/wp-json/wp2/site-manager/v1/categories/1 \
  --header 'X-WP-Nonce: <X-WP-Nonce>'

Deletes the category term. If the category is assigned to any site — 409 term_in_use (sites keep the label, delete is rejected). Requires manage_network.

Authorizations

• cookie
• applicationPassword

Parameters

Path Parameters

id

required

integer

Site Manager category term_id.

Responses

200

Category deleted.

Media typeapplication/json

object

deleted

Always true on HTTP 200.

boolean

id

Deleted category term_id (from the path).

integer

Example

{
  "deleted": true,
  "id": 3
}

400

wp_delete_term WP_Error.

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 term (if PHP reaches format after a failed delete — usually 400 from core).

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_in_use — the category is assigned to one or more sites.

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