Skip to main content
GET
List assets for authorized partner tenants.

Authorizations

Authorization
string
header
required

A Tenant Authority machine-client token from POST /v1/auth/client-token, carrying subject_type=machine_client and the pulse.read scope.

Query Parameters

tenant_ids
string

Comma-separated tenant UUIDs to scope the list to. Omit to use every tenant the caller is authorized for.

include_descendants
enum<string>

When true, widens each id in tenant_ids to that tenant and every tenant beneath it in the hierarchy. Ignored when tenant_ids is omitted, since the default is already the caller's whole scope.

Available options:
true,
false
page_size
string

Maximum number of items per page.

cursor
string

Opaque pagination cursor: pass the previous response's next_cursor to fetch the next page.

expand
string

Comma-separated optional expansions. tenants adds a per-tenant breakdown to each row; cves (on /assets) narrows the list to assets with at least one open finding and attaches their CVEs. Expansions cost extra reads, so ask for them only when needed.

asset_id
string

Restricts the read to a single asset. Asset identifiers are unique within a tenant, not across tenants, so tenant_ids must also be supplied; a request with asset_id and no tenant_ids is rejected with 400 asset_id_requires_tenant_ids.

Response

OK

root_tenant_id
string<uuid>
required
page_size
required
next_cursor
null | string
required
coverage
object[]
required
items
object[]
required