Upload Knowledge Unit

curl --request GET \
  --url https://gateway.widebot.net/api/AIKnowledge/upload-to-s3 \
  --header 'x-bot: <api-key>' \
  --header 'x-user-auth: <api-key>'

{
  "StatusCode": 200,
  "Response": {
    "uploadUrl": "<string>",
    "fileKey": "<string>",
    "expiresIn": 123
  },
  "Consumption": "0/10000000"
}

Upload Knowledge Unit

Get an upload URL for sending the raw file of a knowledge unit. After the upload succeeds, you must call “Add Knowledge” to register the uploaded file as a knowledge unit in your bot.

Process:

Call this endpoint to get an upload URL
Upload your file using the provided URL
Call “Add Knowledge” to register the uploaded file as a knowledge unit

Supported File Types:

PDF documents
Microsoft Word (DOCX)
Plain text (TXT)
Rich text (RTF)
And other common document formats

Note: Example requests/responses shown here are illustrative. When using the live “Try it” tool, you may see two responses: an HTTP status preview and the API’s JSON body.

GET

api

AIKnowledge

upload-to-s3

Upload Knowledge Unit

curl --request GET \
  --url https://gateway.widebot.net/api/AIKnowledge/upload-to-s3 \
  --header 'x-bot: <api-key>' \
  --header 'x-user-auth: <api-key>'

{
  "StatusCode": 200,
  "Response": {
    "uploadUrl": "<string>",
    "fileKey": "<string>",
    "expiresIn": 123
  },
  "Consumption": "0/10000000"
}

Authorizations

x-user-auth

string

header

required

Your API key from account settings

x-bot

string

header

required

Your bot ID from account settings

Response

200 - application/json

Upload URL for file

StatusCode

integer

Example:

200

Response

object

Show child attributes

Response.uploadUrl

string<uri>

Upload URL for file

Response.fileKey

string

File key identifier

Response.expiresIn

integer

URL expiration time in seconds

Consumption

string

Example:

"0/10000000"

Stream Chat Completion Register Knowledge Unit

⌘I

Overview

Endpoints

Upload Knowledge Unit

Authorizations

Response