Gnaww Developer API

The canonical public API host is:

https://api.gnaww.io

The current reviewed developer contract is gnaww-developer-v0.1. It is deliberately narrower than the complete Gnaww implementation service. A route is not a supported public developer operation merely because it exists internally.

Within that reviewed contract, POST /v1/interpret now returns the job-centric gnaww.interpretation_result v0.2 envelope and /v1/interpret/continue accepts the corresponding v0.2 continuation contract. The /v1 operation path remains stable. There is no parallel /v2 interpretation API.

Build by task or inspect by operation

Use Build with Gnaww when you need to connect operations into an integration journey. Use this API section when you need authentication, field-level operation authority, errors or tracing.

The guides do not maintain a second request and response schema. The reviewed API contract remains authoritative.

Contract principles

• public developer routes use the /v1 major path where applicable;
• authenticated operations use scoped developer credentials;
• every approved developer response carries request and correlation identifiers;
• approved developer failures use a stable safe error envelope;
• interpretation can return one or many Jobs without becoming an Order;
• capability truth is kept separate from live price, availability, acceptance and ordering;
• the API, SDKs and CLI depend on the same reviewed contract.

The raw FastAPI application schema and framework documentation are not public API reference surfaces. The developer reference is built only from the reviewed Gnaww developer contract.

Continue with Authentication, API reference and Errors and tracing.