Skip to main content

Delete Contacts Category

DELETE 

/v1/contacts/categories/:id

Delete the Contacts Category with a specific ID.

Route defaults fix extension to com_content, com_contact, com_banners or com_newsfeeds. Do not move a category between component trees by changing extension. lft, rgt and level are maintained by Joomla.

The collection supports filter[state], an integer passed to the publication-state filter. For example, GET /content/categories?filter[state]=1 selects published article categories.

For tree positioning, the controller reads location and location_reference from the JSON body and calls setLocation after saving. location accepts before, after, first-child or last-child; the reference is the category ID, with parent_id used when no explicit reference is provided. Changing ordinary fields and positioning the record are separate steps, so read back the parent and ordering even when the initial save succeeds. Component plugins can add options to the base form. The base edit check requires core.manage and record core.edit, or core.edit.own with a matching owner; component overrides take precedence. Omitted SERVER_UTC/USER_UTC calendar values are restored from the stored UTC values after validation, avoiding a second timezone conversion.

Request​

Responses​

Deleted; no response body is required.