VisualGrid Playbooks

Root Authentication

Authenticate as root operator to obtain a short-lived session token (1h TTL).

POST /visualgrid/root/auth
Content-Type: application/json

{ "secret_code": "<root-secret>" }

Response includes token — pass as x-vg-token header on all subsequent calls.

Tree Navigation

Start at GET /visualgrid/root/graph to see all 21 service table entry nodes. Use POST /visualgrid/node/children with { pk, sk } to drill into org, entity type, and individual instances. Responses are paginated (limit 1-256, opaque next_token).

Property Inspection

Use POST /visualgrid/node/load with { table, pk, sk } to load a single node with full redacted properties. DDB keys are separated into a ddb_keys object. Sensitive fields are fingerprinted or fully redacted.

Export

Use POST /visualgrid/node/export with { table, pk, sk } for a raw JSON export of a single entity. Useful for debugging or snapshotting a specific record.

Schema

Use GET /visualgrid/schema to retrieve the full entity type registry. Returns all known entity types, their table mappings, PK/SK patterns, and metadata (doc_url, mcp_url, service_code).