Stay organized with collections
Save and categorize content based on your preferences.
You can export conversation messages to a
Cloud Storage bucket. Each conversation is exported as a
separate JSON file in the
standard conversation data format.
A maximum of 10,000 conversations can be exported at a time, and each
conversation can have at most 1000 messages.
Authentication and access control
When you send a request to export conversations, use your
end-user credentials for authentication.
Your user account must be granted at least a read role for the Dialogflow
API and an edit role (with the ability to overwrite objects) for the Cloud Storage bucket you want to export data to. For more details on user account
roles see the Cloud Storage access control
and Dialogflow access control documentation.
When executing REST requests at the command-line:
Use gcloud auth login
to authenticate gcloud with your user account.
Only conversations that have been
completed are
available for export. Old conversations are deleted by the system periodically,
so if you try to reference an older conversation it may no longer be available.
[[["Easy to understand","easyToUnderstand","thumb-up"],["Solved my problem","solvedMyProblem","thumb-up"],["Other","otherUp","thumb-up"]],[["Hard to understand","hardToUnderstand","thumb-down"],["Incorrect information or sample code","incorrectInformationOrSampleCode","thumb-down"],["Missing the information/samples I need","missingTheInformationSamplesINeed","thumb-down"],["Other","otherDown","thumb-down"]],["Last updated 2025-08-28 UTC."],[[["\u003cp\u003eThis feature is currently in a pre-general availability (Pre-GA) stage, meaning it is provided "as is" with potentially limited support, and it is subject to the "Pre-GA Offerings Terms".\u003c/p\u003e\n"],["\u003cp\u003eYou can export conversation messages to a Cloud Storage bucket as separate JSON files, with each conversation containing at most 1000 messages, and up to 10,000 conversations can be exported in one request.\u003c/p\u003e\n"],["\u003cp\u003eExporting conversations requires user authentication with at least a read role for the Dialogflow API and an edit role for the designated Cloud Storage bucket.\u003c/p\u003e\n"],["\u003cp\u003eOnly conversations that have been marked as completed are available for export, and older conversations may be deleted over time.\u003c/p\u003e\n"],["\u003cp\u003eTo initiate the export, use the \u003ccode\u003eexportMessages\u003c/code\u003e method, which operates as a long-running operation, requiring you to monitor its status for completion.\u003c/p\u003e\n"]]],[],null,["# Export conversation data\n\n| **Preview**\n|\n|\n| This feature is subject to the \"Pre-GA Offerings Terms\" in the General Service Terms section\n| of the [Service Specific Terms](/terms/service-terms#1).\n|\n| Pre-GA features are available \"as is\" and might have limited support.\n|\n| For more information, see the\n| [launch stage descriptions](/products#product-launch-stages).\n\nYou can export conversation messages to a\n[Cloud Storage](/storage/docs) bucket. Each conversation is exported as a\nseparate JSON file in the\n[standard conversation data format](/agent-assist/docs/conversation-data-format#conversation_transcript_data).\nA maximum of 10,000 conversations can be exported at a time, and each\nconversation can have at most 1000 messages.\n\nAuthentication and access control\n---------------------------------\n\nWhen you send a request to export conversations, use your\n[end-user credentials for authentication](/docs/authentication/end-user).\nYour user account must be granted at least a **read** role for the Dialogflow\nAPI and an **edit** role (with the ability to overwrite objects) for the Cloud Storage bucket you want to export data to. For more details on user account\nroles see the [Cloud Storage access control](/storage/docs/access-control/iam-roles)\nand [Dialogflow access control](/dialogflow/docs/access-control) documentation.\n\nWhen executing REST requests at the command-line:\n\n- Use [`gcloud auth login`](/sdk/gcloud/reference/auth/login) to authenticate `gcloud` with your user account.\n- Use [`gcloud auth print-access-token`](/sdk/gcloud/reference/auth/print-access-token) to create a token for request authentication.\n\nConversations available for export\n----------------------------------\n\nOnly conversations that have been\n[completed](/agent-assist/docs/smart-reply#complete_the_conversation) are\navailable for export. Old conversations are deleted by the system periodically,\nso if you try to reference an older conversation it may no longer be available.\n\nRequest export\n--------------\n\nTo request export, call the\n[`exportMessages`](/dialogflow/es/docs/reference/rest/v2beta1/projects/exportMessages)\nmethod. This method is a\n[long-running operation](/dialogflow/docs/how/long-running-operations), so you\nneed to check the status for completion."]]
