CreateAsset

post

https://app.stairwell.com/v1/environments/{environment}/assets

Creates an asset in an environment.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

environment

string

required

Environment in which to create the asset.

Query Params

idempotencyKey

string

Client-generated key for idempotent asset creation. If provided, repeated
requests with the same key and environment return the existing asset
instead of creating a duplicate.

label

string

Label hint for automatic group assignment. Only takes effect on first
registration - subsequent registrations preserve the existing assignment.

string

OS hint for automatic group assignment. Only takes effect on first
registration - the forwarder reports actual values on subsequent checkins.

osVersion

string

OS version hint for automatic group assignment. Only takes effect on first
registration - the forwarder reports actual values on subsequent checkins.

forwarderVersion

string

Forwarder version hint for automatic group assignment. Only takes effect on
first registration - the forwarder reports actual values on subsequent checkins.

Body Params

An asset represents an endpoint (workstation, server, VM, or container) that
runs the Stairwell forwarder. Assets continuously upload files for analysis and
maintain a complete history of every file ever observed, enabling retrospective
threat hunting and incident investigation.

label

string

required

Human-readable identifier, typically the machine hostname.

Response

Language

Credentials

Header

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200OK