Delete

Delete an existing category.

Tokens

This action requires the following tokens:

  • category-delete

Arguments

Required arguments are marked in bold, and optional arguments are marked in italics.

Argument Type Default Description
category Hash   The ID of the category to delete

Output

This action produces no output on success.

Errors

This action can return one of the default status codes, or one of the following status codes on error:

STATUS_CATEGORY_NOT_FOUND (210)
If the category specified by “ID” can not be found
STATUS_CATEGORY_HAS_LINKED_ITEMS (212)
The category cannot be deleted because it is still in use. It is linked as either the parent of another category, or to an item, record schedule or unfinished record task.