Update a category

Requires a private API key. Only the parameters included in the body of the request will be updated in DropInBlog. 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.

int32
required

The ID of your category.

Body Params
string

Category name shown to visitors. Changing it keeps the slug, so the category URL stays the same; send slug as well to change the URL.

string

New URL slug. Refused with a 422 if another category of the blog, including one in the trash, has it. An empty value rebuilds it from the title. Warning: changing the slug changes the URL of the category page.

string

SEO title for your category. If not set it will default to the title. Send an empty value to remove it.

string

SEO description for your category. Send an empty value to remove it.

string

Plain text shown under the heading of the category page. HTML tags are removed; line breaks are kept. Send an empty value to remove it.

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. Replaces the current image. Send an empty value to remove it.

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