Skip to main content

Return saved search by ID

GET 

https://sailpoint.api.identitynow.com/v2024/saved-searches/:id

Returns the specified saved search.

Request

Path Parameters

    id stringrequired

    ID of the requested document.

    Example: 2c91808568c529c60168cca6f90c1313

Responses

The requested saved search.

Schema
    idstring

    The saved search ID.

    Example: 0de46054-fe90-434a-b84e-c6b3359d0c64
    owner object

    The owner of the saved search.

    typestringrequired

    An enumeration of the types of DTOs supported within the IdentityNow infrastructure.

    Possible values: [ACCOUNT_CORRELATION_CONFIG, ACCESS_PROFILE, ACCESS_REQUEST_APPROVAL, ACCOUNT, APPLICATION, CAMPAIGN, CAMPAIGN_FILTER, CERTIFICATION, CLUSTER, CONNECTOR_SCHEMA, ENTITLEMENT, GOVERNANCE_GROUP, IDENTITY, IDENTITY_PROFILE, IDENTITY_REQUEST, MACHINE_IDENTITY, LIFECYCLE_STATE, PASSWORD_POLICY, ROLE, RULE, SOD_POLICY, SOURCE, TAG, TAG_CATEGORY, TASK_RESULT, REPORT_RESULT, SOD_VIOLATION, ACCOUNT_ACTIVITY, WORKGROUP]

    Example: IDENTITY
    idstringrequired

    The id of the object.

    Example: 2c91808568c529c60168cca6f90c1313
    ownerIdstring

    The ID of the identity that owns this saved search.

    Example: 2c91808568c529c60168cca6f90c1313
    publicboolean

    Whether this saved search is visible to anyone but the owner. This field will always be false as there is no way to set a saved search as public at this time.

    Default value: false
    Example: false
    namestring

    The name of the saved search.

    Example: Disabled accounts
    descriptionstringnullable

    The description of the saved search.

    Example: Disabled accounts
    createddate-timenullable

    The date the saved search was initially created.

    Example: 2018-06-25T20:22:28.104Z
    modifieddate-timenullable

    The last date the saved search was modified.

    Example: 2018-06-25T20:22:28.104Z
    indicesstring[]required

    The names of the Elasticsearch indices in which to search.

    Possible values: [accessprofiles, accountactivities, entitlements, events, identities, roles, *]

    Example: ["identities"]
    columns object

    The columns to be returned (specifies the order in which they will be presented) for each document type.

    The currently supported document types are: accessprofile, accountactivity, account, aggregation, entitlement, event, identity, and role.

    property name* object[]
  • Array [
  • fieldstringrequired

    The name of the field.

    Example: email
    headerstring

    The value of the header.

    Example: Work Email
  • ]
  • querystringrequired

    The search query using Elasticsearch Query String Query syntax from the Query DSL.

    Example: @accounts(disabled:true)
    fieldsstring[]nullable

    The fields to be searched against in a multi-field query.

    Example: ["disabled"]
    orderBy objectnullable

    Sort by index. This takes precedence over the sort property.

    property name* string[]
  • Array [
  • string
  • ]
  • sortstring[]nullable

    The fields to be used to sort the search results.

    Example: ["displayName"]
    filters objectnullable

    The filters to be applied for each filtered field name.

    typestring

    Enum representing the currently supported filter types. Additional values may be added in the future without notice.

    Possible values: [EXISTS, RANGE, TERMS]

    Example: RANGE
    range object

    The range of values to be filtered.

    lower object
    valuestringrequired

    The value of the range's endpoint.

    Example: 1
    inclusiveboolean

    Indicates if the endpoint is included in the range.

    Default value: false
    Example: false
    upper object
    valuestringrequired

    The value of the range's endpoint.

    Example: 1
    inclusiveboolean

    Indicates if the endpoint is included in the range.

    Default value: false
    Example: false
    termsstring[]

    The terms to be filtered.

    excludeboolean

    Indicates if the filter excludes results.

    Default value: false
    Example: false

Authorization: oauth2

type: Personal Access Token
scopes: sp:scopes:all

Request Collapse all
Base URL
https://sailpoint.api.identitynow.com/v2024
Auth
Parameters
— pathrequired
ResponseClear

Click the Send API Request button above and see the response here!