Overview
Ingests a ChatGPT data export (JSON) for a given connection. The export file is normalized into individual conversations and stored in the Verso database.Request
Headers
Body
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Upload and process a ChatGPT data export.
| Header | Value |
|---|---|
Authorization | Bearer YOUR_APP_SECRET |
Content-Type | application/json |
{
"appId": "app_yourapp",
"connectionId": "uuid",
"conversations": [
{
"title": "Conversation title",
"create_time": 1700000000,
"update_time": 1700001000,
"mapping": { ... },
"conversation_id": "chatgpt-uuid"
}
]
}
| Field | Type | Required | Description |
|---|---|---|---|
appId | string | Yes | Your app identifier |
connectionId | string | Yes | The connection to associate data with |
conversations | array | Yes | Array of ChatGPT conversation objects |
{
"ok": true,
"imported": 42,
"skipped": 3
}
| Field | Type | Description |
|---|---|---|
ok | boolean | Always true on success |
imported | number | Number of conversations imported |
skipped | number | Conversations skipped (duplicates or errors) |
| Status | Error | Cause |
|---|---|---|
| 400 | Missing appId | appId field not provided |
| 400 | Missing connectionId | connectionId field not provided |
| 401 | Invalid API key | Wrong or missing Bearer token |
| 404 | Connection not found | Connection ID doesn’t exist |
| 409 | Connection is revoked | Connection was deleted |