Skip to main content
Assets represent things of value that your organization needs to protect — servers, databases, laptops, SaaS applications, and other resources. Each asset records what data it stores and who is responsible for it.

​
The Asset object

​
id
string
required
Global ID (GID) of the asset.
​
organization_id
string
required
GID of the organization this asset belongs to.
​
name
string
required
Name of the asset.
​
amount
integer
required
Quantity of this asset (e.g. number of laptops of this model).
​
owner_id
string
required
GID of the profile responsible for this asset.
​
asset_type
AssetType
required
Whether the asset is physical or virtual. See AssetType enum.
​
data_types_stored
string
required
Description of the types of data stored on or processed by this asset.
​
snapshot_id
string | null
GID of the snapshot this asset record belongs to, or null for live data.
​
created_at
string (date-time)
required
ISO 8601 timestamp of when the asset was created.
​
updated_at
string (date-time)
required
ISO 8601 timestamp of the last update.

​
AssetType enum

ValueDescription
PHYSICALA tangible, physical asset (e.g. laptop, server, USB drive)
VIRTUALA digital or cloud-based asset (e.g. SaaS application, database, repository)

​
Operations

​
listAssets

Returns all assets for the organization. MCP tool: listAssets

​
Parameters

​
organization_id
string
required
GID of the organization.
​
size
integer
Number of results per page.
​
cursor
string
Pagination cursor from a previous response’s next_cursor.
​
order_by
object
​
filter
object

​
Response

​
assets
Asset[]
required
Array of asset objects.
​
next_cursor
string
Cursor for the next page.

​
getAsset

Returns a single asset by ID. MCP tool: getAsset

​
Parameters

​
id
string
required
GID of the asset.

​
Response

​
asset
Asset
required
The requested asset object.

​
addAsset

Creates a new asset. MCP tool: addAsset

​
Parameters

​
organization_id
string
required
GID of the organization.
​
name
string
required
Asset name.
​
amount
integer
required
Quantity of the asset.
​
owner_id
string
required
GID of the asset owner profile.
​
asset_type
AssetType
required
Asset type (PHYSICAL or VIRTUAL).
​
data_types_stored
string
required
Description of data stored on this asset.
​
vendor_ids
string[]
GIDs of vendors associated with this asset (e.g. the cloud provider hosting a virtual asset).

​
Response

​
asset
Asset
required
The created asset object.

​
updateAsset

Updates an existing asset. MCP tool: updateAsset

​
Parameters

​
id
string
required
GID of the asset to update.
​
name
string
Updated name.
​
amount
integer
Updated quantity.
​
owner_id
string | null
Updated owner GID.
​
asset_type
AssetType
Updated asset type.
​
data_types_stored
string
Updated data types description.
​
vendor_ids
string[]
Updated list of associated vendor GIDs.

​
Response

​
asset
Asset
required
The updated asset object.

​
Example

curl -X POST https://your-probo-instance/api/mcp/v1 \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "addAsset",
      "arguments": {
        "organization_id": "gid://probo/Organization/01J5XKZW9QMXP3N6V8HTJA2FKB",
        "name": "Production PostgreSQL database",
        "amount": 1,
        "owner_id": "gid://probo/Profile/01J5XKZW9QMXP3N6V8HTJA2FKC",
        "asset_type": "VIRTUAL",
        "data_types_stored": "Customer PII, payment records, authentication credentials"
      }
    }
  }'
Assets support snapshots — point-in-time records used during audits. Pass a snapshot_id to the listAssets filter to retrieve the asset register as it existed at a specific audit period.

Build docs developers (and LLMs) love

Get started for freeTalk to us