Playground

Playground

CloudResource

/api/v1/cloud-resources

A cloud resource discovered or managed (EC2, S3, GKE node).

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.
external_idstringNative cloud provider resource identifier (e.g. EC2 instance ID 'i-0a1b2c3d4e5f67890', Azure resource ID, GCP resource name).
providerstringCloud provider hosting this resource.
account_idstringCloud provider account or subscription ID where this resource resides.
regionstringCloud provider region where this resource is located.
resource_typestringCloud provider resource type in dot-notation format (e.g. 'ec2.instance', 's3.bucket', 'rds.instance', 'lambda.function', 'azure.vm', 'gcp.compute.instance').
resource_namestringHuman-readable name or tag-based name of this cloud resource. May be the 'Name' tag value for AWS resources.
arnstringAmazon Resource Name (ARN) for AWS resources. Null for non-AWS resources.
statusstringCurrent operational state of the cloud resource as reported by the cloud provider.
asset_iduuidUUID of the TechnologyAsset this CloudResource is part of or implements. Links infrastructure-level resources to business-level asset records.
tagsjsonCloud provider tags applied to this resource as key-value pairs. Synced directly from the cloud provider.
costjsonEstimated monthly cost for this cloud resource based on cloud provider billing data.

API

client.cloudResources.*
Loading manifest…