Skip to content

Verity — Access Decay Intelligence Platform

Assets

Assets¶

Assets represent data resources discovered across connected platforms — tables, views, dashboards, lakehouses, warehouses, and more.

Asset Schema¶

Field	Type	Description
`id`	UUID	Verity-assigned unique identifier.
`platform`	string	Source platform (e.g. `snowflake`, `fabric`, `databricks`).
`platform_id`	string	Native identifier on the source platform.
`asset_type`	string	Type of asset (e.g. `table`, `view`, `dashboard`, `warehouse`).
`fqn`	string	Fully-qualified name (e.g. `PROD.ANALYTICS.CUSTOMERS`).
`display_name`	string	Human-readable name.
`sensitivity`	string	Sensitivity classification: `PUBLIC`, `INTERNAL`, `CONFIDENTIAL`, `RESTRICTED`.
`sensitivity_source`	string	How sensitivity was determined: `manual`, `auto`, `catalog`.
`contains_pii`	boolean	Whether the asset contains personally identifiable information.
`pii_column_count`	integer	Number of columns flagged as PII.
`data_owner_id`	UUID	Verity ID of the designated data owner (nullable).
`steward_id`	UUID	Verity ID of the data steward (nullable).
`is_active`	boolean	Whether the asset is currently active / discovered.
`first_seen_at`	datetime	When the asset was first discovered.
`last_seen_at`	datetime	When the asset was last observed in a snapshot.
`metadata`	object	Connector-specific key-value data.
`created_at`	datetime	Record creation timestamp.
`updated_at`	datetime	Record last-updated timestamp.

List Assets¶

GET /v1/assets

Retrieve a paginated list of assets with optional filters.

Query Parameters¶

Parameter	Type	Default	Description
`platform`	string	—	Filter by source platform (e.g. `snowflake`, `fabric`).
`sensitivity`	string	—	Filter by sensitivity level: `PUBLIC`, `INTERNAL`, `CONFIDENTIAL`, `RESTRICTED`.
`search`	string	—	Full-text search across `display_name` and `fqn`.
`cursor`	string	—	Pagination cursor from a previous response.
`limit`	integer	50	Items per page (max 100).

Example Request¶

curl -s "http://localhost:8000/v1/assets?platform=snowflake&sensitivity=CONFIDENTIAL&limit=2" \
  -H "Authorization: Bearer $TOKEN"

Example Response¶

{
  "items": [
    {
      "id": "019f3d4e-5f60-7000-8000-000000000100",
      "platform": "snowflake",
      "platform_id": "PROD.ANALYTICS.CUSTOMERS",
      "asset_type": "table",
      "fqn": "PROD.ANALYTICS.CUSTOMERS",
      "display_name": "Customers",
      "sensitivity": "CONFIDENTIAL",
      "sensitivity_source": "catalog",
      "contains_pii": true,
      "pii_column_count": 5,
      "data_owner_id": "019f1a2b-3c4d-7000-8000-000000000099",
      "steward_id": "019f1a2b-3c4d-7000-8000-000000000050",
      "is_active": true,
      "first_seen_at": "2024-11-01T00:00:00Z",
      "last_seen_at": "2025-07-14T06:00:00Z",
      "metadata": {
        "database": "PROD",
        "schema": "ANALYTICS",
        "row_count": 2450000
      },
      "created_at": "2024-11-01T08:00:00Z",
      "updated_at": "2025-07-14T06:00:00Z"
    },
    {
      "id": "019f3d4e-5f60-7000-8000-000000000101",
      "platform": "snowflake",
      "platform_id": "PROD.ANALYTICS.TRANSACTIONS",
      "asset_type": "table",
      "fqn": "PROD.ANALYTICS.TRANSACTIONS",
      "display_name": "Transactions",
      "sensitivity": "CONFIDENTIAL",
      "sensitivity_source": "auto",
      "contains_pii": true,
      "pii_column_count": 3,
      "data_owner_id": "019f1a2b-3c4d-7000-8000-000000000099",
      "steward_id": null,
      "is_active": true,
      "first_seen_at": "2024-11-01T00:00:00Z",
      "last_seen_at": "2025-07-14T06:00:00Z",
      "metadata": {
        "database": "PROD",
        "schema": "ANALYTICS",
        "row_count": 18700000
      },
      "created_at": "2024-11-01T08:00:00Z",
      "updated_at": "2025-07-14T06:00:00Z"
    }
  ],
  "next_cursor": "eyJpZCI6IjAxOWYzZDRlLTVmNjAtNzAwMC04MDAwLTAwMDAwMDAwMDEwMiJ9"
}

Get Asset¶

GET /v1/assets/{id}

Retrieve a single asset by its Verity ID.

Path Parameters¶

Parameter	Type	Description
`id`	UUID	The asset's Verity UUID.

Example Request¶

curl -s "http://localhost:8000/v1/assets/019f3d4e-5f60-7000-8000-000000000100" \
  -H "Authorization: Bearer $TOKEN"

Example Response¶

{
  "id": "019f3d4e-5f60-7000-8000-000000000100",
  "platform": "snowflake",
  "platform_id": "PROD.ANALYTICS.CUSTOMERS",
  "asset_type": "table",
  "fqn": "PROD.ANALYTICS.CUSTOMERS",
  "display_name": "Customers",
  "sensitivity": "CONFIDENTIAL",
  "sensitivity_source": "catalog",
  "contains_pii": true,
  "pii_column_count": 5,
  "data_owner_id": "019f1a2b-3c4d-7000-8000-000000000099",
  "steward_id": "019f1a2b-3c4d-7000-8000-000000000050",
  "is_active": true,
  "first_seen_at": "2024-11-01T00:00:00Z",
  "last_seen_at": "2025-07-14T06:00:00Z",
  "metadata": {
    "database": "PROD",
    "schema": "ANALYTICS",
    "row_count": 2450000
  },
  "created_at": "2024-11-01T08:00:00Z",
  "updated_at": "2025-07-14T06:00:00Z"
}

Error Responses¶

Status	Description
404	Asset not found.

List Grants on an Asset¶

GET /v1/assets/{id}/grants

Retrieve all active access grants that target a specific asset.

Path Parameters¶

Parameter	Type	Description
`id`	UUID	The asset's Verity UUID.

Query Parameters¶

Parameter	Type	Default	Description
`cursor`	string	—	Pagination cursor.
`limit`	integer	50	Items per page (max 100).

Example Request¶

curl -s "http://localhost:8000/v1/assets/019f3d4e-5f60-7000-8000-000000000100/grants?limit=2" \
  -H "Authorization: Bearer $TOKEN"

Example Response¶

{
  "items": [
    {
      "id": "019f2c3d-4e5f-7000-8000-000000000010",
      "principal_id": "019f1a2b-3c4d-7000-8000-000000000001",
      "asset_id": "019f3d4e-5f60-7000-8000-000000000100",
      "platform": "snowflake",
      "privilege": "READ",
      "grant_mechanism": "role",
      "granted_via": "ANALYST_ROLE",
      "granted_at": "2024-01-15T10:00:00Z",
      "granted_by_id": null,
      "is_active": true,
      "revoked_at": null,
      "revoked_by_id": null,
      "snapshot_at": "2025-07-14T06:00:00Z",
      "metadata": {}
    },
    {
      "id": "019f2c3d-4e5f-7000-8000-000000000012",
      "principal_id": "019f1a2b-3c4d-7000-8000-000000000003",
      "asset_id": "019f3d4e-5f60-7000-8000-000000000100",
      "platform": "snowflake",
      "privilege": "ADMIN",
      "grant_mechanism": "direct",
      "granted_via": null,
      "granted_at": "2023-08-01T09:00:00Z",
      "granted_by_id": "019f1a2b-3c4d-7000-8000-000000000099",
      "is_active": true,
      "revoked_at": null,
      "revoked_by_id": null,
      "snapshot_at": "2025-07-14T06:00:00Z",
      "metadata": {}
    }
  ],
  "next_cursor": null
}