Create site category

POST

/wp-json/wp2/site-manager/v1/categories

curl --request POST \
  --url https://example.com/wp-json/wp2/site-manager/v1/categories \
  --header 'Content-Type: application/json' \
  --header 'X-WP-Nonce: <X-WP-Nonce>' \
  --data '{ "name": "Training projects", "slug": "training", "parent_id": 0 }'

Creates a category taxonomy term (wp_insert_term on the main site). Non-empty name after trim is required, otherwise 400 missing_name. Requires manage_network.

Authorizations

• cookie
• applicationPassword

Request Body^required

Media typeapplication/json

object

name

required

Display name of the category. Required; empty after trim — 400 missing_name.

string

slug

Term slug. Optional; PHP runs sanitize_title. If omitted, core generates it from name.

string

parent_id

Parent term_id. Optional, default 0 (root).

integer

Example

{
  "name": "Training projects",
  "slug": "training",
  "parent_id": 0
}

Responses

201

Category created.

Media typeapplication/json

object

id

Site category term_id (Site Manager taxonomy, not post categories).

integer

name

Term display name. In the list PHP may rewrite default labels via translate_default_term_label.

string

slug

Category term slug (sanitize_title on write).

string

parent

Parent term_id (WP_Term->parent); 0 — root. PHP omits this field in SiteDto.categories.

integer

Example

{
  "id": 3,
  "name": "Training projects",
  "slug": "training",
  "parent": 0
}

400

Missing_name — empty name; other wp_insert_term WP_Error (except 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": {}
}

409

Term_exists — a term with that name/slug already 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": {}
}