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

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.