tomevault-io Telvok Authentication
Connect your Telvok account to access the marketplace, bounties, and publishing.
Tool
auth({ action }) - Manage your Telvok connection
Actions
| Action | Description |
|---|---|
login |
Start device code flow — returns a code and URL |
complete |
Finish login after browser authorization |
status |
Check if currently authenticated |
logout |
Remove stored credentials |
Login Flow
auth({ action: "login" })— Returns a code (e.g., "FBAM-57AJ") and URL- User visits telvok.com/device in their browser
- User enters the code and authorizes
auth({ action: "complete" })— Saves API key locally
Credentials are stored in .librarian/.auth as JSON:
{
"api_key": "tvk_...",
"user_email": "you@example.com",
"user_id": "uuid",
"created_at": "...",
"expires_at": "..."
}
When Auth is Required
These tools require authentication:
library_buy()- Purchasing bookslibrary_publish()- Publishing booksbounty_create()/bounty_claim()/bounty_submit()- Bountiesmy_books()- Viewing your libraryseller_analytics()- Sales datarate_book()- Rating bookssync()- Syncing purchased contentmy_bounties()- Your bountiesfeedback()- Sending feedback
Troubleshooting
"Authentication required" error:
Run auth({ action: "status" }) to check. If not connected, run auth({ action: "login" }).
Expired key:
API keys expire after 90 days. Run auth({ action: "login" }) to get a new one.
Wrong account:
Run auth({ action: "logout" }) then auth({ action: "login" }) with the correct account.
See Also
- librarian-marketplace - Buy, sell, and search books
- librarian-bounties - Knowledge bounty system
- librarian - Local knowledge capture
Converted and distributed by TomeVault — claim your Tome and manage your conversions.