Asset Identifiers

Every asset in Stairwell has a unique identifier. Understanding the different identifier types is essential for API integrations, forwarder management, and file uploads.

Types of Asset Identifiers

• Asset ID -- A unique identifier assigned to each asset (forwarder endpoint). Used when referencing a specific asset in API calls or the UI.
• Default Asset ID -- Every environment has a built-in asset called __DefaultAsset__. When uploading files via the API, you must provide a valid Asset ID. If you do not need to associate an upload with a specific asset, use the Default Asset ID.
• Maintenance Token -- A short-lived, environment-specific token used to authorize forwarder maintenance operations such as entering maintenance mode before an uninstall or update. Tokens are valid for 14 days.

Find an Asset Identifier

From the Assets list

1. Navigate to app.stairwell.com/assets.
2. Locate the asset in the list.
3. Check the value in the Identifier column.

From the Asset panel

1. Click on an individual asset from the assets list.
2. Find the value next to ID in the asset detail panel.

From the Windows Registry

1. Open Registry Editor (regedit).
2. Navigate to HKLM\Software\Stairwell\Inception\AssetId.
3. The AssetId value is your asset identifier.

Find the Default Asset ID

1. Navigate to app.stairwell.com/assets.
2. Select the Assets tab.
3. Locate the asset named __DefaultAsset__ in the list.
4. Click anywhere on the row.
5. Note the value next to ID -- this is your Default Asset ID.

Why this matters: The file intake API requires a valid Asset ID for every upload. When uploading via the UI, the default asset is selected automatically. When using the API, you must supply an Asset ID explicitly. If you do not need uploads associated with a specific asset, use the Default Asset ID.

Find a Maintenance Token

1. Navigate to app.stairwell.com/assets.
2. If you manage multiple environments, select the correct environment from the dropdown.
3. Click Forwarder Maintenance Token.
4. Click Generate.
5. Copy the token and store it in a secure location.

Note: Maintenance tokens are tied to a specific environment. Tokens are valid for 14 days. Generate a new token if yours has expired.