v1

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

Find lenses

Find a lens or lenses. You may query using field filters with asterisk (*) wildcards. You may also optionally specify sort, limit, offset, and a list of fields to include in the response. The global default limit will apply if no limit param is specified.

get/lenses

Query parameters

fieldsstring[]

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

sortstring[]

Specify the sort order using a field name, e.g. '...?sort=name'. Prepend the field name with a minus sign to specify descending order, e.g. '...?sort=-name'.

limitinteger

Maximum number of records to return in the response; also useful for pagination in the UI.

offsetinteger

Offset for paginating the response.

descriptionstring

A description of the lens.

helpEmailstring

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

helpUrlstring

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

lensEventApiVersioninteger

The API version for the Lens Event API, e.g. 1, 2, etc.

isCustomboolean

True for any lens which is installed by an administrator (rather than pre-installed in Focus).

isPublishedboolean

True for any lens which is available to users.

namestring

The name of the lens.

sourceDescriptionstring

The original lens publisher's description of the lens.

sourceNamestring

The original lens publisher's name of the lens.

sourceVersionstring

The original lens publisher's version of the lens.

versionstring

The version of the lens.

createdAtstring

Filter by time period when lenses were created.

updatedAtstring

Filter by time period when lenses were updated.

Response

Success, returns a list of lenses.

descriptionstring

A description of the lens.

helpEmailstring

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

helpUrlstring

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

idstring

The lens id.

isCustomboolean

True for any lens which is installed by an administrator (rather than pre-installed in Refocus).

isPublishedboolean

True when the lens is available to users.

lensEventApiVersioninteger

The API version for the Lens Event API, e.g. 1, 2, etc.

namestring

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

sourceDescriptionstring

The original lens publisher's description of the lens.

sourceNamestring

The original lens publisher's name of the lens.

sourceVersionstring

The original lens publisher's version of the lens.

thumbnailUrlstring

Optional thumbnail image to represent the lens.

installedBystring

TODO

createdBystring

Id of the User who created this Lens.

createdAtstring

TODO

updatedAtstring

TODO