POST /sites/$site/taxonomies/$taxonomy/terms/slug:$slug
Edit a term.
Resource Information
Method | POST |
---|---|
URL | https://public-api.wordpress.com/rest/v1.1/sites/$site/taxonomies/$taxonomy/terms/slug:$slug |
Requires authentication? | Yes |
Method Parameters
Parameter | Type | Description |
---|---|---|
$site | (int|string) | Site ID or domain |
$taxonomy | (string) | Taxonomy |
$slug | (string) | The term slug |
Query Parameters
Parameter | Type | Description |
---|---|---|
context | (string) |
|
http_envelope | (bool) |
|
pretty | (bool) |
|
meta | (string) | Optional. Loads data from the endpoints found in the 'meta' part of the response. Comma-separated list. Example: meta=site,likes |
fields | (string) | Optional. Returns specified fields only. Comma-separated list. Example: fields=ID,title |
callback | (string) | An optional JSONP callback function. |
Request Parameters
Parameter | Type | Description |
---|---|---|
name | (string) | Name of the term |
description | (string) | A description of the term |
parent | (int) | The parent ID for the term, if hierarchical |
Response Parameters
Parameter | Type | Description |
---|---|---|
ID | (int) | The category ID. |
name | (string) | The name of the category. |
slug | (string) | The slug of the category. |
description | (string) | The description of the category. |
post_count | (int) | The number of posts using this category. |
feed_url | (string) | The URL of the feed for this category. |
parent | (int) | The parent ID for the category. |
meta | (object) | Meta data |
Resource Errors
This endpoint does not return any errors.
Example
curl \ -H 'authorization: Bearer YOUR_API_TOKEN' \ --data-urlencode 'description=The most delicious' \ 'https://public-api.wordpress.com/rest/v1/sites/82974409/taxonomies/post_tag/terms/slug:testing-term'
<?php $options = array ( 'http' => array ( 'ignore_errors' => true, 'method' => 'POST', 'header' => array ( 0 => 'authorization: Bearer YOUR_API_TOKEN', 1 => 'Content-Type: application/x-www-form-urlencoded', ), 'content' => http_build_query( array ( 'description' => 'The most delicious', )), ), ); $context = stream_context_create( $options ); $response = file_get_contents( 'https://public-api.wordpress.com/rest/v1/sites/82974409/taxonomies/post_tag/terms/slug:testing-term', false, $context ); $response = json_decode( $response ); ?>