Skip to main content
POST
Search Asset

Authorizations

Authorization
string
header
required

Aspect API key (sk_...) in Authorization header. 'Bearer ' optional.

Path Parameters

asset_id
string<uuid>
required

The ID of the asset to search within

Body

application/json

API request schema for searching within a specific asset.

project_id
string<uuid>
required

ID of the project the asset belongs to

spec
Spec · object
required

User-facing search spec to execute

Response

Successful Response

Search metadata for an asset — ordering score, moments, confidence, and matched signals.

score
number
required

Ordering score across all signals used for result ranking

confidence
enum<string>
required

Asset-level confidence rating derived from the best local evidence confidence

Available options:
unknown,
low,
medium,
high
moments
SearchMoment · object[]

Typed local evidence moments for asset-level and timeline display

signals
SearchSignalSummary · object[]

Asset-level logical signals that contributed to this result