Sign in

v1

latestSwagger 2.0BSD 3-Clause2026-07-1720953437.1 KB
subjects

Get subject

Retrieve the specified subject by its id or name. You may also optionally specify a list of fields to include in the response.

get/subjects/{key}

Path parameters

keystring required

The id or absolute path of the subject to retrieve.

Query parameters

fieldsstring[]

Comma-delimited list of field names to include in the response.

Response

Success, returns specified subject.

absolutePathstring

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

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