Skip to main content
POST
Run Generation

Authorizations

Authorization
string
header
required

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

Path Parameters

attribute_id
string<uuid>
required

Attribute ID

Query Parameters

dry_run
boolean
default:false

Count the assets the run would cover without starting it. Not supported when target.kind is assets.

Body

application/json

API request schema for a run: what it does and which assets it covers.

mode
enum<string>
required

fill runs only the assets not run yet (or whose last run failed); overwrite re-runs every asset, replacing the AI's answers; answers entered by hand are kept unless replace_manual is true

Available options:
fill,
overwrite
target
WatchRunTarget · object
required

Every asset the attribute watches; rejected when it watches nothing.

replace_manual
boolean
default:false

With overwrite, also replace answers entered by hand. Ignored by fill

Response

Successful Response

API response schema for an explicit run's counts.

count
integer
required

Assets the run covers. Hand-entered values are included only with replace_manual.

manually_entered
integer | null

Assets with a hand-entered value. Set only by overwrite dry runs.