Skip to main content

Retrieve discovered applications for tenant

GET 
/discovered-applications

Fetches a list of applications that have been identified within the environment. This includes details such as application names, discovery dates, potential correlated saas_vendors and related suggested connectors.

Request​

Query Parameters

    limit int32

    Possible values: <= 250

    Default value: 250

    Max number of results to return. See V3 API Standard Collection Parameters for more information.

    Example: 250
    offset int32

    Default value: 0

    Offset into the full result set. Usually specified with limit to paginate through the results. See V3 API Standard Collection Parameters for more information.

    Example: 0
    detail string

    Possible values: [SLIM, FULL]

    Determines whether slim, or increased level of detail is provided for each discovered application in the returned list. SLIM is the default behavior.

    Example: FULL
    filter string

    Filter results using the standard syntax described in V3 API Standard Collection Parameters

    Filtering is supported for the following fields and operators:

    name: eq, sw, co

    description: eq, sw, co

    createdAtStart: eq, le, ge

    createdAtEnd: eq, le, ge

    discoveredAtStart: eq, le, ge

    discoveredAtEnd: eq, le, ge

    discoverySource: eq, in

    Example: name eq "Okta" and description co "Okta" and discoverySource in ("csv", "Okta Saas")
    sorters comma-separated

    Sort results using the standard syntax described in V3 API Standard Collection Parameters

    Sorting is supported for the following fields: name, description, discoveredAt, discoverySource

    Example: name

Responses​

List of discovered applications. By default, the API returns a list of SLIM discovered applications.

Schema

  • Array [

    • oneOf

    Discovered applications

    id uuid

    Unique identifier for the discovered application.

    name string

    Name of the discovered application.

    discoverySource string

    Source from which the application was discovered.

    discoveredVendor string

    The vendor associated with the discovered application.

    description string

    A brief description of the discovered application.

    recommendedConnectors string[]

    List of recommended connectors for the application.

    discoveredAt date-time

    The timestamp when the application was last received via an entitlement aggregation invocation or a manual csv upload, in ISO 8601 format.

    createdAt date-time

    The timestamp when the application was first discovered, in ISO 8601 format.

    status string

    The status of an application within the discovery source.

    By default this field is set to "ACTIVE" when the application is discovered.

    If an application has been deleted from within the discovery source, the status will be set to "INACTIVE".

  • ]

Loading...