File Operations

Upload a file

Upload a file to be used with a chatbot, for example as a files attachment in /chat or /live-chat. The file is stored in the chatbot's folder under its original name. If a file with that name already exists, it is not replaced: nothing is uploaded and the existing file's URL is returned. Uploads count toward the workspace's file storage limit.

post/upload-file/{chatbotId}

Request

  • Base URL: https://api.chat-data.com/api/v2
  • URL: https://api.chat-data.com/api/v2/upload-file/{chatbotId}
  • Auth: HTTP bearer

Path parameters

chatbotIdstring required

The unique identifier allocated to the chatbot.

Response

Successful response.

status'success' required
urlstring required

The URL where the uploaded file can be accessed, with a read-only SAS token.

Example response

{
  "url": "https://example.blob.core.windows.net/chatfiles/6650f1c2a9e4b83d2c7a1f05/product-handbook.pdf?sv=2024-11-04&se=2026-11-13T09%3A30%3A00Z&sr=b&sp=r&sig=Xq7mB2v9KpL4tR8wN1cZ5yF3hJ6dS0aE%2BuG7iO2kQ%3D"
}

Changes

No recorded changes to this operation across all 1 revision of this API.