v1

latestSwagger 2.0BSD 3-Clause2026-07-1720953437.1 KB

aspects

Create aspect

Create a new aspect.

post/aspects

Request body

descriptionstring

A description of the aspect. 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 aspect. A lens may choose to display this information to the user e.g. if the user clicks a “help” icon attached to the aspect.

helpUrlstring

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

imageUrlstring

Optional icon to represent the aspect.

isPublishedboolean

This affects the visibility of samples; defaults to false. When set to true, all the samples for this aspect are readable by other users; when set to false, the samples for this aspect are only readable by the owner of the aspect.

namestring required

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

criticalRangenumber[]

A two-element array of type decimal. Determines what range of values should be assigned Critical status.

warningRangenumber[]

A two-element array of type decimal. Determines what range of values should be assigned Warning status.

infoRangenumber[]

A two-element array of type decimal. Determines what range of values should be assigned Info status.

okRangenumber[]

A two-element array of type decimal. Determines what range of values should be assigned OK status.

timeoutstring required

The length of time after which a sample is treated as 'N/A', in the form of /^[0-9]+[smhd]$/i. For example, use '5s' for five seconds, '2m' for two minutes, '12h' for twelve hours, '1d' for one day.

valueLabelstring

A short label the lens may display next to the value. Most useful to specify a unit of measurement, e.g. 'ms' or '%'.

valueType'BOOLEAN' | 'NUMERIC' | 'PERCENT'

The sample value must be able to be coerced to the specified data type. This allows a lens to render sample data in different ways depending on their type.

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 (-).

ranknumber

Provide guidance for how a lens should display aspects--ascending order by rank (numeric, nulls last) then within rank in ascending order by name (alphanumeric).

ownerstring

The name of the user to assign as the owner. Defaults to the user that created it

Example request

{
  "criticalRange": [
    1,
    7
  ],
  "warningRange": [
    1,
    7
  ],
  "infoRange": [
    1,
    7
  ],
  "okRange": [
    1,
    7
  ]
}

Response

Created.

descriptionstring

A description of the aspect. 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 aspect. A lens may choose to display this information to the user e.g. if the user clicks a “help” icon attached to the aspect.

helpUrlstring

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

idstring

The aspect id.

imageUrlstring

Optional icon to represent the aspect.

isPublishedboolean

namestring

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

criticalRangenumber[]

A two-element array of type decimal. Determines what range of values should be assigned to status value 0.

warningRangenumber[]

A two-element array of type decimal. Determines what range of values should be assigned to status value 1.

infoRangenumber[]

A two-element array of type decimal. Determines what range of values should be assigned to status value 2.

okRangenumber[]

A two-element array of type decimal. Determines what range of values should be assigned to status value 3.

timeoutstring

The length of time after which a sample is treated as 'N/A', in the form of /^[0-9]+[smhd]$/i. For example, use '5s' for five seconds, '2m' for two minutes, '12h' for twelve hours, '1d' for one day.

valueLabelstring

A short label the lens may display next to the value. Most useful to specify a unit of measurement, e.g. 'ms' or '%'.

valueType'BOOLEAN' | 'NUMERIC' | 'PERCENT'

The sample value must be able to be coerced to the specified data type. This allows a lens to render sample data in different ways depending on their type.

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 (-).

Example response

{
  "criticalRange": [
    1,
    7
  ],
  "warningRange": [
    1,
    7
  ],
  "infoRange": [
    1,
    7
  ],
  "okRange": [
    1,
    7
  ]
}