API Documentation
Prospects
Agents
VoiceModels
Hive
HiveAgentLink
Actions
ActionAgentLink
Products
Conversations
ConversationProspectLink
Hive
Create a New Hive
Hive is a collection of documents that are used to train the Agent. Hive can be a PDF, DOCX, TXT or a website URL
POST
/
v1
/
hives
Copy
curl --request POST \
--url https://api.trata.ai/v1/hives \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"hiveType": "WEBSITE",
"url": "<string>",
"file_ids": [
"<string>"
],
"hiveProps": {}
}'
Copy
{
"id": "hiv.1727418138.IPGwVl1f",
"orgId": "org.1726902940.GZChqlpU",
"content": {
"hiveType": "WEBSITE",
"url": "https://www.cotekoreansteakhouse.com/",
"hiveProps": {
"crawl_child_pages": true
}
},
"status": "completed",
"createdBy": "org.1726902940.GZChqlpU",
"createdAt": "2024-09-27T06:22:18.000277",
"updatedBy": "trata-system",
"updatedAt": "2024-09-27T06:27:34.276065"
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Body
application/json
Response
200
application/json
Hive created successfully
Reference to all business knowledge base will be stored in Hive
Copy
curl --request POST \
--url https://api.trata.ai/v1/hives \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"hiveType": "WEBSITE",
"url": "<string>",
"file_ids": [
"<string>"
],
"hiveProps": {}
}'
Copy
{
"id": "hiv.1727418138.IPGwVl1f",
"orgId": "org.1726902940.GZChqlpU",
"content": {
"hiveType": "WEBSITE",
"url": "https://www.cotekoreansteakhouse.com/",
"hiveProps": {
"crawl_child_pages": true
}
},
"status": "completed",
"createdBy": "org.1726902940.GZChqlpU",
"createdAt": "2024-09-27T06:22:18.000277",
"updatedBy": "trata-system",
"updatedAt": "2024-09-27T06:27:34.276065"
}
Assistant
Responses are generated using AI and may contain mistakes.