Skip to main content
Retrieve a list of configurations with optional filtering.
External DocumentationTo learn more, visit the Upwind documentation.

​
Basic Parameters

ParameterDescription
Framework IDThe framework ID to filter results by.
Organization IDThe ID of the organization.
Page TokenThe page token to retrieve the next set of results.
Per PageThe maximum number of results to return per page.
Resource NameThe resource name to filter results by.
Return All PagesAutomatically fetch all resources, page by page.
SeverityThe severity of the item.

​
Advanced Parameters

ParameterDescription
Check IDThe check ID to filter results by.
Check TitleThe check title to filter results by.
Cloud Account TagsThe cloud account tags to filter results by.

Use key=value format to specify tags. Multiple tags can be specified by separating them with commas.
Framework TitleThe framework title to filter results by.
Include Cloud Account TagsSelect to include cloud account tags in the response.
Max Last Seen TimeThe date and time used to filter results that were last seen on or before this value.
Min Last Seen TimeThe date and time used to filter results that were last seen on or after this value.
StatusThe status of the configuration to filter results by.

​
Example Output

{
	"resourceFindings": [
		{
			"id": "string",
			"status": "PASS",
			"severity": "LOW",
			"title": "string",
			"description": "string",
			"first_seen_time": "2024-07-29T15:51:28.071Z",
			"last_seen_time": "2024-07-29T15:51:28.071Z",
			"framework": {
				"id": "string",
				"status": "ENABLED",
				"version": "string",
				"revision": "string",
				"title": "string",
				"description": "string",
				"cloud_provider": "string"
			},
			"check": {
				"id": "string",
				"title": "string",
				"remediation": "string",
				"description": "string"
			},
			"resource": {
				"id": "string",
				"external_id": "string",
				"name": "string",
				"type": "string",
				"cloud_provider": "AWS",
				"region": "string",
				"cluster_id": "string",
				"cloud_account_id": "string",
				"cloud_account_name": "string",
				"namespace": "string",
				"internet_exposure": {
					"ingress": {
						"active_communication": true
					}
				},
				"cloud_account_tags": [
					{
						"key": "string",
						"value": "string"
					}
				],
				"risk_categories": [
					"string"
				]
			},
			"last_sync_time": "2024-07-29T15:51:28.071Z"
		}
	],
	"pagination": {
		"totalItems": 0,
		"size": 0,
		"offset": 0,
		"nextPageToken": [
			null
		],
		"hasMoreData": true
	}
}

​
Workflow Library Example

List Configuration Findings with Upwind and Send Results Via Email
Workflow LibraryPreview this Workflow on desktop