← capabilities

Json Query

Extract one bounded value from caller-supplied JSON using a deterministic simple path such as items[2].name or $.data.id. Forest performs no network request or model inference, returns an explicit found flag, and supports only dot object keys plus numeric array indexes so lookup behavior stays predictable.

Forest exposes this capability as a deterministic machine-readable API for software agents. Discovery is free; execution uses the canonical paid endpoint below. The live x402 challenge is the source of truth for payment terms.

$0.001 / callPOST /json/queryx402 · Base

Typical agent tasks

This capability is intended for bounded machine decisions such as:

What Forest guarantees

Boundaries

Machine contract

The request and response schemas are published in the canonical OpenAPI document. This page shows a representative input from the same production manifest.

Input example

{ "json": { "items": [ { "name": "a" }, { "name": "b" } ] }, "path": "items[1].name" }

Canonical paid endpoint

https://http--forest-gas-station-mainnet--lcjl27p8lmjs.code.run/json/query

OpenAPI contract →

Related capabilities