PlanetGraph Schema and Query Shapes

Node shape (simplified)
- id
- type
- owner
- status
- created_at
- updated_at

Edge shape (simplified)
- id
- type
- source_id
- target_id
- owner
- status
- created_at
- updated_at

Key filter semantics
- /api/v1/nodes?type=<node_type>
- /api/v1/edges?type=<edge_type>
- /api/v1/edges?source_type=<node_type>
- /api/v1/edges?target_type=<node_type>

Property access states
- owned
- granted
- locked

Declared schema discovery
- planetgraph_schema_describe reports visible Node/Edge types and type-level Property capabilities declared through PropertyAccess and PropertySearch.
- properties and searchable_properties are independent lists; Search does not imply value returnability.
- Declarations are not a physical schema. A record may omit a declared Property, and undeclared Properties may exist.
- Each declaration category is bounded. Check truncated and narrow with node_type, edge_type, or property_name filters.
- Use include_properties=true on bounded Node/Edge list calls to inspect actual authorized values.

Query endpoint
- POST /api/v1/query returns:
  - nodes
  - edges
  - tabular
  - count
  - execution_time_ms
  - tokens_charged