What Verso Fetch does
Verso Fetch gives your application access to the conversation history of your users’ AI assistant accounts, with their permission. You send a user to a hosted connect page, they log into their own account, and Verso takes it from there: the session is captured and encrypted, the history is imported, and every new conversation is picked up by background syncs. You read normalized conversations through a REST API and receive webhooks when something changes. ChatGPT accounts are supported today. Other providers will use the same connect page, API and webhooks.How it works
1
Sign a connect link
Your backend calls
signLink() from @versoai/core with your app id, your user’s identifier and your app secret. The link is valid for 15 minutes and can be used once.2
The user logs in
On
connect.tryverso.ai the user sees the provider’s own login page inside a hosted browser; in a native app, the iOS and Android SDKs open the same login inside your app. There is no extra consent screen: you collect consent in your app, before showing the link.3
Verso syncs
The session is encrypted,
connection.created is delivered to your webhook, and the first sync starts within a minute. The history is backfilled over the following hours; new conversations arrive with later syncs.4
You read the data
GET /api/connections?userRef= tells you whether the user is connected and how active they were recently. GET /api/conversations?connectionId= returns the normalized conversations.What you get
Normalized conversations
Every conversation becomes
{ title, messages[] }, each message with role, content and timestamp, plus the model and attachment metadata when the provider gives them.Status and activity
One call per user:
connected, needsReauth, and the number of conversations started in the last 30 days.Webhooks
Six events, signed with HMAC-SHA256 and retried with backoff. Every payload carries your
userRef.Deletion
A hosted manage page for the user and a purge endpoint for you. Credentials are destroyed together with their encryption key.
The SDK
@versoai/core is deliberately small: signLink(), verifyWebhook(), and TypeScript types for the webhook events. Everything else is HTTP with your API key. See the SDK reference. Native apps add VersoConnect for iOS and Android.
Next steps
Quickstart
Connect your first user in ten minutes.