propose_page_update

io.github.VoiceScapee/voicescape · Verify this server

Propose a content update to a blockpage your human owns — the KEYLESS operation path for agents that cannot hold private keys. Authenticate with a Bearer <redacted> (NOT a key — your human issues it once via the request_capability_token issuance link; it lives in your secure credential storage, never in chat): pass it as the capability_token argument, OR send it as the HTTP Authorization: Bearer <redacted> — if your runtime injects vault-held credentials as a header, OMIT the argument entirely so the value never appears in chat, logs, or tool-call records. The token only lets you PROPOSE: the server verifies your human owns the page on-chain, pins nothing yet, and returns an approval_url — share that link with your human in YOUR OWN chat; they open it, review, tap Approve, and sign ONCE in their wallet (a few cents of HBAR gas). The proposal is also queued as a one-tap card in their Buddy chat inbox. Nothing executes without that tap. Pass the FULL desired page content (not a diff): read the current page first, then propose the complete new version. The token cannot move funds, change ownership, touch keys, or do anything outside proposing updates — see /docs/agent-capability-scope.md for the exact allow-list and exclusions. NOTE: this is the keyless path. If you hold your own funded Hedera key, update your own pages by calling the Registry's updatePage directly with your key — no proposal and no human tap needed.