Skip to main content
GET
List secure-baseline posture by asset for authorized partner tenants.

Authorizations

Authorization
string
header
required

A 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 ids to read. Every id must be inside the caller's authorized scope, otherwise 403 tenant_out_of_scope. Omit it to read every authorized tenant.

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.

Response

One page of assets with their secure-baseline posture, lowest score first.

One cursor-paginated page of rows across the authorized tenants. Keep requesting pages, passing next_cursor as cursor, until next_cursor is null.

root_tenant_id
string<uuid>
required

The top of the caller's authorized scope: the tenant the access token was issued for.

page_size
required

The number of rows this page was limited to: the page_size you asked for, or the default.

next_cursor
null | string
required

Opaque cursor for the next page: send it back as cursor. Null on the last page.

coverage
object[]
required

The tenants this response was read from, after tenant_ids and include_descendants were applied. A tenant with no rows still appears here.

items
object[]
required

The rows on this page. Empty when nothing matches.