Skip to main content
GET
/
agents
/
{agentId}
/
convos
/
export
Export Agent Conversations
curl --request GET \
  --url https://eu-gcp-api.vg-stuff.com/v3/agents/{agentId}/convos/export \
  --header 'Authorization: Bearer <token>'
{
  "success": true,
  "message": "<string>",
  "data": [
    {}
  ]
}

​
Example Response

{
  "success": true,
  "message": "Conversations exported successfully",
  "data": [
    {
      "metadata": {
        "feedback": "Positive",
        "convo": {
          "id": "convo123",
          "userName": "John Doe",
          "userEmail": "[email protected]",
          "userPhone": "+1234567890",
          "userCompany": "Acme Corp",
          "notes": "Customer interested in premium plan",
          "tags": ["new-lead", "high-priority"]
        },
        "sessions": []
      },
      "turns": [
        {
          "from": "user",
          "messages": [
            {
              "type": "text",
              "ts": "December 1st 2024, 10:30:00 am",
              "payload": {
                "message": "Hello!",
                "feedback": "Unset"
              }
            }
          ]
        }
      ]
    }
  ]
}

​
Use Cases

  • Analytics - Export all conversations for external analysis
  • Backup - Create a backup of all conversation data
  • Training - Export conversations for AI training purposes

​
Notes

  • Returns all conversations with full turn history
  • Includes feedback status (Positive, Negative, Unset)
  • Timestamps are formatted as human-readable strings
  • All lead fields are included: userName, userEmail, userPhone, userCompany, userAddress, userWebsite, notes, tags

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
agentId
string
required

The unique identifier of the agent

Query Parameters

​
format
enum<string>
default:json

Export format (json or csv)

Available options:
csv,
json

Response

Conversations exported successfully

​
success
boolean
required
​
message
string
required
​
data
object[]
required