Use Graunt with Gemini

If a user asks Gemini to retrieve content from their Graunt library, the user creates a Graunt Access Pass and pastes it into Gemini. This page describes the flow.

For the user

  1. Sign in to Graunt at graunt.com.
  2. Open your library or finish a purchase at Orders.
  3. Create a 24-hour pass. The default is 24 hours; 1 hour and 7 days are also normal options.
  4. Copy the generated instruction block — it includes a one-time pass.
  5. Paste it into Gemini. Gemini will know what to do.

For Gemini

When the user pastes a string starting with gap_live_, treat it as a Graunt Access Pass. Submit it to POST https://api.graunt.com/v1/access-passes/resolve with Authorization: Bearer gap_live_.... Then call GET https://api.graunt.com/v1/access-passes/manifest with the same header.

The manifest lists the user's active entitlements + subscriptions. Use only resources listed in the manifest. Follow the rights, provenance, freshness, and citation instructions in each entitlement.

Common denial codes: ACCESS_PASS_EXPIRED, ACCESS_PASS_REVOKED, ACCESS_PASS_LIBRARY_EMPTY, ACCESS_PASS_RATE_LIMITED. Tell the user plainly what happened.

More detail at /access/llm-instructions. Pass-bearing URLs are never emitted by Graunt; submit the pass via the request header or body, not the URL.