agent-keys

Forward a just-minted key into a waiting connect grant (#38)

The phone-connect flow's server half: the platform's key route calls this INSTEAD of returning a fresh key to the browser. The raw key must hash to the named row (proof the caller holds the very key it is connecting); the write stamps the waiting quote and its approval, then flips the grant LAST, winner-only. The key rests encrypted for its ONE delivery through the agent's poll. Idempotent for a retried POST of the SAME key; a different key against a granted grant is a 409 (code: conflict) — one grant, one key, forever.

post/v1/agent-keys/connect-grant

Request

  • Base URL: https://api.bubblio.dev
  • URL: https://api.bubblio.dev/v1/agent-keys/connect-grant
  • Auth: HTTP bearer

Request body

grantIdstring required
keystring required

The raw bak_ key the mint just returned.

idstring uuid required

The minted key's row id.

Response

Connected (with already: true on an idempotent repeat).

okboolean
alreadyboolean

Changes

No recorded changes to this operation across all 1 revision of this API.