Playground

Playground

TechnologyAsset

/api/v1/technology

A piece of technology your org runs (SaaS, internal service, system).

listgetcreateupdatedelete

Schema

FieldTypeNotes
id*uuidServer-assigned ULID with type prefix (e.g. per_…).
tenant_id*stringTenant scope — auto-stamped from the caller's JWT.
app_idstringApp scope. Stamped ONLY when the caller's JWT was minted for a specific Application (integration API keys). Absent for human-user sessions. Filters reads when present.
created_at*date-timeServer stamp.
updated_at*date-timeServer stamp; updated on every patch.
created_byuuidPerson id from the caller's JWT (sub).
updated_byuuidPerson id from the last writer's JWT (sub).
sourcestringProvenance tag — defaults to 'edm'.
source_typeenumfrontend | backend | server | system | apiWhere the write originated. Defaults to 'api'.
is_deletedbooleanSoft-delete flag. Excluded from default list queries.
deleted_atdate-timeStamped when soft-deleted; null otherwise.
deleted_byuuidPerson id who soft-deleted; null otherwise.
schema_versionnumberDocument schema version. Bumped on incompatible writes.
namestringShort, machine-friendly name for the asset (no spaces, kebab-case recommended). Used in API paths and internal references.
display_namestringHuman-readable display name for the asset as shown in the UI.
descriptionstringDetailed description of this asset, its purpose, and its role in the enterprise technology stack.
typestringTechnology classification of this asset.
categorystringBusiness category of the asset (e.g. 'identity', 'productivity', 'security', 'cloud', 'devtools'). Used for grouping in dashboards.
vendorstringName of the vendor or publisher of this asset.
versionstringCurrent deployed version of the asset. Null for SaaS products where version is vendor-managed.
statusstringLifecycle status of this asset. 'deprecated' assets are being phased out but still operational. 'decommissioned' assets are retired.
ownerjsonThe person and optionally a group responsible for this asset's governance, access approvals, and lifecycle decisions.
environmentstringDeployment environment. 'dr' is disaster recovery.
hostingstringWhere this asset is hosted. 'saas' indicates a fully vendor-managed product.
cloud_providerstringCloud provider when hosting is 'cloud' or 'hybrid'. Null otherwise.
regionstringCloud or datacenter region where this asset is primarily hosted.
urlstringPrimary URL for accessing this asset (e.g. the application URL, admin console, or API endpoint).
tagsjsonArray of tag strings for grouping, filtering, and policy application.
criticalitystringBusiness criticality rating. 'critical' assets affect core business operations and require the strictest access controls.
data_classificationstringHighest data classification level processed or stored by this asset. Drives data handling and encryption requirements.
owner_iduuidUser / person id of the primary owner of this asset.

API

client.technology.*
Loading manifest…