Skip to content

List Assets

GET
/assets

The latest completed snapshot’s assets. A failed run never becomes the snapshot served here, the prior completed one stays visible. ADR-0023: the account filter (visibility, or the explicit aws_account_id param) narrows which runs are eligible to be the snapshot, so an account-restricted caller gets their accounts’ latest completed run, never another account’s.

tenant_id
required
Tenant Id
string format: uuid
asset_type
Any of:
string
Allowed values: iam_role iam_user vpc subnet security_group s3_bucket transfer_server rds_instance dynamodb_table
aws_account_id
Any of:
string format: uuid
st_session
Any of:
string

Successful Response

AssetInventoryResponse

The latest completed snapshot. run_id is null until a run completes.

object
assets
required
Assets
Array<object>
AssetRecord
object
asset_type
required
Asset Type
string
aws_id
required
Aws Id
string
discovery_run_id
required
Discovery Run Id
string format: uuid
id
required
Id
string format: uuid
name
required
Name
string
region
required
Region
string
summary
required
Summary
object
key
additional properties
any
tenant_aws_account_id
Any of:
string format: uuid
completed_at
required
Any of:
string format: date-time
run_id
required
Any of:
string format: uuid

Validation Error

HTTPValidationError
object
detail
Detail
Array<object>
ValidationError
object
ctx
Context
object
input
Input
loc
required
Location
Array
msg
required
Message
string
type
required
Error Type
string