Create a category

Requires a private API key. The new category goes last in the blog's category order. If a value you sent was changed, such as a flag a private category keeps on, the response has a notes list saying so.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

Your blog ID.

Body Params
string
required

Category name shown to visitors.

string

URL friendly identifier for the category. If omitted, it is built from the title and made unique. A slug you send is refused with a 422 if another category of the blog, including one in the trash, has it.

string

SEO title for your category. If not set it will default to the title.

string

SEO description for your category.

string

Plain text shown under the heading of the category page. HTML tags are removed; line breaks are kept.

string

Public URL of a JPEG, PNG, GIF, WebP or AVIF image (max 10 MB) for the category page header. It is downloaded and stored with your blog; if it can't be used, nothing is saved and a 422 is returned.

boolean

Private category: left out of the category menu, the main blog page and search engines, while its posts still open at their URL. While true, hide_from_menu, hide_posts_from_main_list and no_index are always on.

boolean

Leave the category out of the category menu.

boolean

Keep the category in the menu but leave its posts out of the main blog page.

boolean

Hide the category page from search engines.

Responses

Language
Credentials
OAuth2
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json