← gridviper.com

Frequently Asked Questions

Quick answers. For anything else, contact support.

What is GridViper?

A cloud API for real-time pathfinding. You send a grid, we return paths. Works with any language that speaks HTTP — no SDK or engine plugin required.


Do you guarantee optimal paths?

Paths are near-optimal (typically within 28% of shortest possible). The tradeoff is speed: queries run 8–15× faster than A* in dynamic workloads. For most games and simulations, near-optimal paths that arrive in under 5ms matter more than perfect paths that take 50ms.


What's "replanning"?

Replanning means changing an agent's goal without recomputing the entire grid. Traditional pathfinders restart from scratch each time. GridViper reuses the precomputed navigation field, which is why replanning is 8–13× faster.


Why do I need /v1/precompute?

It builds a navigation field for your grid. This is a one-time cost per grid layout. After that, every path query against that grid is fast. Think of it like indexing a database — you pay once, query many times.


What are the limits by tier?

Free: 5,000 queries/month, 1 grid. Indie ($99): 50,000 queries, 1 grid. Studio ($299): 250,000 queries, 5 grids. Simulation ($999): 1,000,000 queries, 20 grids. All paid tiers include a 20% overage buffer.


What happens when I hit my quota?

Paid tiers get a 20% buffer beyond the base quota before requests are blocked. You'll see usage in the X-Usage-Percent response header on every request. When you're getting close, upgrade or contact support for higher usage.


Can I get more queries beyond my tier limit?

Contact support to discuss higher usage. We offer top-up blocks and custom plans for teams that need more.


What auth header do I use?

Either X-API-Key: gv_... or Authorization: Bearer gv_... — both work on every endpoint.


Can I use this for robotics or simulations?

Yes. The API handles 2D grid-based pathfinding for any use case — games, warehouse robotics, traffic simulation, crowd modeling. If your environment can be represented as a grid with obstacles, GridViper works.


Where are servers located?

US East (Virginia) initially. We'll add more regions as we scale based on where our customers are.


Do you store my grids?

Grids are cached in memory to serve your path queries. They are not written to disk and are cleared on server restart. Do not upload sensitive or personally identifiable data as grid content.


Can I delete a grid?

Yes. Send DELETE /v1/grid/{grid_id} with your API key to remove a cached grid immediately.


How do I cancel my subscription?

Call POST /v1/billing/portal with your API key to get a link to your Stripe billing portal. From there you can update your card, change plans, or cancel.


How do I get support?

Visit the Support page. We aim to respond to all requests as quickly as possible.

API status: api.gridviper.com/health