SAsalesforce
subjects

Delete subject

Delete the specified subject. You will not be allowed to delete a subject if it has any children subjects under it. Beware! Deleting a subject also deletes all the samples associated with this subject.

delete/subjects/{key}

Request

  • Base URL
    /v1 (relative, and the document was published on a file host, not at the API’s origin)
  • URL
    /v1/subjects/{key}
  • Auth
    API key in header Authorization

Path parameters

keystring required

The id or absolute path of the subject to delete.

Response

Success, returns deleted subject.

absolutePathstring

The absolute path of the subject. This is automatically set based on the name and hierarchy.

childrenSubjectsResponse[] circular
descriptionstring

A description of the subject. A lens may choose to display this information to the user.

helpEmailstring

The email address where a user can go to get more help about the subject. A lens may choose to display this information to the user e.g. if the user clicks a “help” icon attached to the subject.

helpUrlstring

The url where a user can go to get more help about the subject. A lens may choose to display this information to the user e.g. if the user clicks a “help” icon attached to the subject.

idstring
imageUrlstring

Optional icon to represent the subject.

isPublishedboolean

Default false. When set to true, the subject is readable by other users; when set to false, the subject is only readable by its owner.

namestring

Max 60 characters; case insensitive; allows alpha-numeric characters, underscore (_) and dash (-).

sortBystring

The sortBy string can be used to define the sort order of subjects which a lens developer can choose to honor when rendering the data. The attribute is defaulted to an empty string when the user does not provide any string value. Max 254 characters; case insensitive; allows alpha-numeric characters, + underscore () and dash (-). Filter by sortBy; asterisk (*) wildcards ok. Max 254 characters; case insensitive; allows alpha-numeric characters, underscore () and dash (-).

parentIdstring

The id of the subject's parent, empty if this subject is at the root of the hierarchy.

parentAbsolutePathstring

The absolute path of the subject's parent, empty if this subject is at the root of the hierarchy.

createdBystring

Id of the User who created this Aspect.

createdAtstring

TODO

updatedAtstring

TODO

tagsstring[]

Array of tag names. Tag name: Max 60 characters; case insensitive; allows alpha-numeric characters, underscore (_) and dash (-). Tag names cannot start with a dash (-).

samplesobject[]

TODO

hierarchyLevelinteger

The depth of the subject starting from the root. The root always has a hierarchy level of 1

Changes

No recorded changes to this operation across all 70 revisions of this API.