Skip to content
First
Esc
↑↓navigate↵open⌘Jpreview

Delete one of tags

Deletes the row for good and returns it as it was.

Access: WordPress core’s own rules for this route decide.

DELETE/tags/{id}
Authorization

Optional — this operation also accepts unauthenticated requests.

wordpress_logged_in_{hash}API key · cookie

WordPress's logged-in cookie, as a browser holds it after signing in. A request with it must also carry X-WP-Nonce.

X-WP-NonceAPI key · header

A WordPress REST nonce (wp_create_nonce('wp_rest')) for the cookie's session.

or
AuthorizationBasic auth · header

A WordPress user name and one of the user's application passwords.

or
AuthorizationBearer token (JWT) · header

A First Identity access token.

Path parameters
idinteger | stringrequired

The row's id, or slug:<slug>.

Responses
200

The row.

dataWordPressTermrequired
Show properties
idinteger
namestring | null
slugstring | null
descriptionstring
parentinteger | null
countinteger
urlstring | null
401

An error, as an RFC 9457 problem document.

typestringrequired

Always about:blank: code names the problem.

titlestringrequired

The problem in a few words.

statusintegerrequired

The HTTP status.

codestringrequired

A stable name for the problem, such as unauthenticated, forbidden, not_found, invalid_input, invalid_query, invalid_json, method_not_allowed, unique_violation or reference_violation.

detailstringrequired

What went wrong, for a person.

pointerstring

A JSON pointer to the field of the request at fault, when there is one.

403

An error, as an RFC 9457 problem document.

typestringrequired

Always about:blank: code names the problem.

titlestringrequired

The problem in a few words.

statusintegerrequired

The HTTP status.

codestringrequired

A stable name for the problem, such as unauthenticated, forbidden, not_found, invalid_input, invalid_query, invalid_json, method_not_allowed, unique_violation or reference_violation.

detailstringrequired

What went wrong, for a person.

pointerstring

A JSON pointer to the field of the request at fault, when there is one.

404

An error, as an RFC 9457 problem document.

typestringrequired

Always about:blank: code names the problem.

titlestringrequired

The problem in a few words.

statusintegerrequired

The HTTP status.

codestringrequired

A stable name for the problem, such as unauthenticated, forbidden, not_found, invalid_input, invalid_query, invalid_json, method_not_allowed, unique_violation or reference_violation.

detailstringrequired

What went wrong, for a person.

pointerstring

A JSON pointer to the field of the request at fault, when there is one.

default

An error, as an RFC 9457 problem document.

typestringrequired

Always about:blank: code names the problem.

titlestringrequired

The problem in a few words.

statusintegerrequired

The HTTP status.

codestringrequired

A stable name for the problem, such as unauthenticated, forbidden, not_found, invalid_input, invalid_query, invalid_json, method_not_allowed, unique_violation or reference_violation.

detailstringrequired

What went wrong, for a person.

pointerstring

A JSON pointer to the field of the request at fault, when there is one.

Try it
Server
Authorization (optional)
Parameters
Request
curl -X DELETE 'https://example.space.fast/__first/api/v1/tags/0' \
  -H 'X-WP-Nonce: YOUR_API_KEY' \
  -H 'Cookie: wordpress_logged_in_{hash}=YOUR_API_KEY' \
  -H 'Accept: application/json'
Response
{
  "data": {
    "id": 0,
    "name": "string",
    "slug": "string",
    "description": "string",
    "parent": 0,
    "count": 0,
    "url": "string"
  }
}