Delete site

DELETE

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

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

Deletes the blog via wpmu_delete_blog. Query drop_tables=true drops the site tables.

    Network main site — 403 `main_site_forbidden`. Requires `delete_sites` or `manage_network`.

Authorizations

• cookie
• applicationPassword

Parameters

Path Parameters

blog_id

required

integer

Site ID in the current network (WP_Site->blog_id). A site from another network — 404 site_not_in_network.

Query Parameters

drop_tables

boolean

True — pass true as the second argument to wpmu_delete_blog (drop the site DB tables). false/omitted — blogs-table row without dropping tables, as core defaults.

Responses

200

Site deleted.

Media typeapplication/json

object

deleted

Always true on HTTP 200.

boolean

blog_id

Deleted site ID (from the path).

integer

Example

{
  "deleted": true,
  "blog_id": 5
}

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 delete_sites/manage_network, main_site_forbidden, 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

Site_not_in_network — site is not in the current network.

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

500

Delete_failed — wpmu_delete_blog returned false.

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