List Assets

Returns a list of assets.

External Documentation

To learn more, visit the Sekoia.io documentation.

Basic Parameters

Parameter	Description
Asset Categories	A comma separated list of asset categories to filter by.
Asset Name	Filter by the asset's name.
Asset Types	A comma separated list of asset types to filter by.
Asset UUIDs	A comma separated list of asset UUIDs to filter by.
Direction	The direction of the sort.
Return All Pages	Automatically fetch all resources, page by page.
Sort	Sort returned assets by a provided field.
Sources	A comma separated list of asset sources to filter by.

Advanced Parameters

Parameter	Description
Community UUIDs	A comma separated list of asset community UUIDs to filter by.
Include Revoked	Select to include revoked assets in the search results.
Incorporate Atoms	Select to enrich returned assets with their detection properties.
Limit	The number of items to retrieve. The allowed range is 1-100. The default is 20.
Offset	The number of items to skip when paginating. Must be bigger or equal to 0.
Reviewed	If set to True, filters reviewed assets only.
Rule UUIDs	A comma separated list of asset rule UUIDs to filter by.
Rule Version	A comma separated list of asset discovery rules versions to filter by.
Search In Detection Properties	Select to search by attached detection property.
Search In Tags	Select to search by asset tags.
With Telemetry	Select to Enrich returned assets with their telemetry statistics.

Example Output

{
    "total": 0,
    "items": [
        {
            "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
            "entity_uuid": "ccd0bbaa-1979-4620-9054-a91c61d70e41",
            "community_uuid": "e391588b-4c35-45eb-a5af-211fba0cde08",
            "name": "string",
            "type": "string",
            "category": "string",
            "criticality": 0,
            "created_at": "2019-08-24T14:15:22Z",
            "created_by": "ee824cad-d7a6-4f48-87dc-e8461a9201c4",
            "created_by_type": "string",
            "updated_at": "2019-08-24T14:15:22Z",
            "first_seen": "2019-08-24T14:15:22Z",
            "last_seen": "2019-08-24T14:15:22Z",
            "nb_events": 0,
            "nb_alerts": 0,
            "nb_atoms": 0,
            "atoms": {},
            "props": {},
            "tags": [],
            "revoked": false,
            "revoked_at": "2019-08-24T14:15:22Z",
            "revoked_by": "609d09bf-be33-45e0-963a-ff4cf608e85c",
            "reviewed": false,
            "reviewed_at": "2019-08-24T14:15:22Z",
            "reviewed_by": "92ab4dbc-1b27-40ce-b24b-7dde8f4709be",
            "source": "manual",
            "rule_uuid": "32fa9e3e-fc95-4447-9cd6-8b81210a70f6",
            "rule_version": "string",
            "criticity": {},
            "asset_type": {}
        }
    ]
}

Workflow Library Example

List Assets with Sekoiaio and Send Results Via Email

Preview this Workflow on desktop