# PlanetGraph Agent Quickstart

## Goal
Get an agent to perform graph reads and relationship discovery quickly.

PlanetGraph is generic. The warm-intro flow described below is an example workflow, not a platform constraint.

## Steps
1) **Read OpenAPI**  
   - [https://api.planetgraph.ai/openapi.json](https://api.planetgraph.ai/openapi.json)

2) **Authenticate**  
   - Add header: `X-API-Key: <key>`

3) **Discover current graph shape**  
   - List node samples by type via `GET /api/v1/nodes?type=Person`  
   - List edge samples by type via `GET /api/v1/edges?limit=50`

4) **Query warm-intro relationships**  
   - `POST /api/v1/query` with shared-employer pattern.

5) **Iterate**  
   - Refine by source_type, target_type, and edge type filters.

## Important
- `GET /api/v1/edges?type` filters edge labels.  
- For node-type filtering use `source_type` and `target_type`.