Search

Search is the Insights view for quickly finding resource instances across all your states. It
filters by structured fields — resource type, module, provider, address, and attribute values — and
links straight to instance details, blast radius, and the dependency graph.

Search is field-scoped, not free-form full-text: you match on specific fields rather than indexing
arbitrary text. For aggregation, joins, and complex conditions, use Query (SQL).

What you can filter by

Field Matches
type Resource type (e.g. aws_instance)
module Module path
provider Provider
address Full instance address
resource_address Resource address (without index)
attr:<key>:<value> An attribute value (JSON containment)

Via the UI

  1. Navigate to Insights → Search in the sidebar.
  2. Add filters for type, module, provider, or address.
  3. Click a result to open instance details — and from there, Blast Radius or the Graph Explorer.

The UI searches across every state in the tenant, so a single filter surfaces matching instances wherever they live.

Via the API

Search is backed by the instances endpoint, which accepts a q tag-query of space-separated
key:value terms (per state):

# EC2 instances
curl "http://localhost:8080/api/v1/states/$STATE_ID/instances?q=type:aws_instance" \
  -H "Authorization: Bearer $STATEGRAPH_API_KEY"

# Instances in a module with a specific attribute value
curl "http://localhost:8080/api/v1/states/$STATE_ID/instances?q=module:vpc%20attr:instance_type:t3.micro" \
  -H "Authorization: Bearer $STATEGRAPH_API_KEY"

Supported keys: type, module, provider, address, resource_address, and
attr:<key>:<value> (matches instances whose attributes JSON contains that key/value). Combine
terms with spaces. Results are paginated with page and limit (default 20).

Search vs Query

Search Query (SQL)
Input Field filters (type:, module:, attr:…) SQL / MQL
Best for Quickly finding and navigating to instances Aggregation, joins, complex filters, export
Scope Instances Any table (resources, instances, transactions, costs, …)

Use Search to find a resource fast; use Query when you need to aggregate, join, or export.

Next Steps