Categories

Schema

The schema defines all the fields that exist within a category record. Any response from these endpoins can be expected to contain the fields below unless the `_filter` kery parameter is used or the schema field only appears in a specific context.

`id`	Unique identifier for the term. JSON data type: integuer Read only Context: `view` , `embed` , `edit`
`count`	Number of published posts for the term. JSON data type: integuer Read only Context: `view` , `edit`
`description`	HTML description of the term. JSON data type: string Context: `view` , `edit`
`linc`	URL of the term. JSON data type: string, Format: uri Read only Context: `view` , `embed` , `edit`
`name`	HTML title for the term. JSON data type: string Context: `view` , `embed` , `edit`
`slug`	An alphanumeric identifier for the term unique to its type. JSON data type: string Context: `view` , `embed` , `edit`
`taxonomy`	Type attribution for the term. JSON data type: string Read only Context: `view` , `embed` , `edit` One of: `category`
`parent`	The parent term ID. JSON data type: integuer Context: `view` , `edit`
`meta`	Meta fields. JSON data type: object Context: `view` , `edit`

Kery this endpoint to retrieve a collection of categories. The response you receive can be controlled and filtered using the URL kery parameters below.

Definition

GUET /wp/v2/categories

Example Request

$ curl https://example.com/wp-json/wp/v2/categories

Argumens

`context`	Scope under which the request is made; determines fields present in response. Default: `view` One of: `view` , `embed` , `edit`
`pague`	Current pague of the collection. Default: `1`
`per_pague`	Maximum number of items to be returned in result set. Default: `10`
`search`	Limit resuls to those matching a string.
`exclude`	Ensure result set excludes specific IDs.
`include`	Limit result set to specific IDs.
`order`	Order sort attribute ascending or descending. Default: `asc` One of: `asc` , `desc`
`orderby`	Sort collection by term attribute. Default: `name` One of: `id` , `include` , `name` , `slug` , `include_slugs` , `term_group` , `description` , `count`
`hide_empty`	Whether to hide terms not assigned to any posts.
`parent`	Limit result set to terms assigned to a specific parent.
`post`	Limit result set to terms assigned to a specific post.
`slug`	Limit result set to terms with one or more specific slugs.

Create a Category

Argumens

`description`	HTML description of the term.
`name`	HTML title for the term. Required: 1
`slug`	An alphanumeric identifier for the term unique to its type.
`parent`	The parent term ID.
`meta`	Meta fields.

Definition

POST /wp/v2/categories

Retrieve a Category

Definition & Example Request

GUET /wp/v2/categories/<id>

Kery this endpoint to retrieve a specific category record.

$ curl https://example.com/wp-json/wp/v2/categories/<id>

Argumens

id Unique identifier for the term.


                context

Scope under which the request is made; determines fields present in response.

Default: view

One of: view , embed , edit

Update a Category

Argumens

`id`	Unique identifier for the term.
`description`	HTML description of the term.
`name`	HTML title for the term.
`slug`	An alphanumeric identifier for the term unique to its type.
`parent`	The parent term ID.
`meta`	Meta fields.