Ingest ChatGPT Export - Verso Fetch

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

Header	Value
`Authorization`	`Bearer YOUR_APP_SECRET`
`Content-Type`	`application/json`

Body

{
  "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

Response

{
  "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)

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