v1

latestSwagger 2.0BSD 3-Clause2026-07-1720953437.1 KB

perspectives

Update perspective (full)

Update the specified perspective. If a field is not included in the query body, that field will be set to null or its default value.

put/perspectives/{key}

Path parameters

keystring required

The id or name of the perspective to update.

Request body

namestring required

The name of the perspective.

rootSubjectstring required

The absolute path of the root subject.

aspectFilterstring[]

Array of aspect names to filter; Aspect name: Max 60 characters; case insensitive; allows alpha-numeric characters, underscore (_) and dash (-).

aspectTagFilterstring[]

Array of aspect tag names to filter; Tag name: Max 60 characters; case insensitive; allows alpha-numeric characters, underscore (_) and dash (-).

subjectTagFilterstring[]

Array of subject tag names to filter; Tag name: Max 60 characters; case insensitive; allows alpha-numeric characters, underscore (_) and dash (-).

statusFilterstring[]

Array of sample status to filter; Status values can only be one of these: Critical, Invalid, Timeout, Warning, Info, OK, -Critical, -Invalid, -Timeout, -Warning, -Info, -OK.

lensIdstring required

The id of Lens.

aspectFilterType'INCLUDE' | 'EXCLUDE'

aspectTagFilterType'INCLUDE' | 'EXCLUDE'

subjectTagFilterType'INCLUDE' | 'EXCLUDE'

statusFilterType'INCLUDE' | 'EXCLUDE'

ownerstring

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

Response

Success, returns the updated perspective

idstring

namestring

The name of the perspective.

rootSubjectstring

The absolute path of the root subject.

aspectFilterstring[]

Array of aspect names to filter; Aspect name: Max 60 characters; case insensitive; allows alpha-numeric characters, underscore (_) and dash (-).

aspectTagFilterstring[]

Array of aspect tag names to filter; Tag name: Max 60 characters; case insensitive; allows alpha-numeric characters, underscore (_) and dash (-).

subjectTagFilterstring[]

Array of subject tag names to filter; Tag name: Max 60 characters; case insensitive; allows alpha-numeric characters, underscore (_) and dash (-).

aspectFilterType'INCLUDE' | 'EXCLUDE'

aspectTagFilterType'INCLUDE' | 'EXCLUDE'

subjectTagFilterType'INCLUDE' | 'EXCLUDE'

statusFilterstring[]

Array of sample status to filter; Status values can only be one of these: Critical, Invalid, Timeout, Warning, Info, OK, -Critical, -Invalid, -Timeout, -Warning, -Info, -OK.

createdBystring

TODO

createdAtstring

TODO

updatedAtstring

TODO

lensIdstring

The id of Lens.