Remove user from site

DELETE

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

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

Removes the user from the blog (remove_user_from_blog). The global WordPress account is not deleted.

    Requires permission to manage the blog (for administrator on the site — same as add, `manage_network_users`/`manage_network`).

Authorizations

• cookie
• applicationPassword

Parameters

Path Parameters

blog_id

required

integer

Site ID in the current network (WP_Site->blog_id).

user_id

required

integer

WordPress user ID to remove from this site.

Responses

200

User removed from the site.

Media typeapplication/json

object

removed

Always true on HTTP 200.

boolean

user_id

Removed user ID (from the path).

integer

Example

{
  "removed": true,
  "user_id": 14
}

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

No permission on the blog (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": {}
}