# 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**

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