Skip to main content

RemoveClass

Remove one empty node or customer connection category. Requires objects.delete permission.

An exact node target is its type and class, for example {"target":"image","class":"Photos"}.

An exact customer connection target uses an endpoint-type object plus all three class names:

{
"target": {"src_type": "entity", "dst_type": "image"},
"class": "AppearsIn",
"src_class": "People",
"dst_class": "Photos"
}

Node targets reject endpoint class fields. Exact connection targets require both endpoint types and classes. Class names are nonempty, cannot begin with _, and are matched without case sensitivity. Index selectors additionally include property and kind. GetIndexes permits partial selectors; other metadata commands require an exact category.

The category must have no live objects or indexes. Node categories must also have no dependent customer connection categories, even if those are empty. Remove the dependent indexes/categories explicitly; this command never deletes objects. After removal commits, the numeric category ID can be reused by a later class. A reused node category may have another node type. New object birth transactions keep old _uniqueid values from selecting replacement objects, while existing readers retain their original category snapshot.

[{"RemoveClass":{"target":"image","class":"Pictures"}}]

Success returns status: 0. Nonempty categories, dependent indexes/categories and invalid selectors fail the transaction.