Skip to main content
PUT
/
v1
/
hives
/
{hive_id}
Update a Specific Hive by ID
curl --request PUT \
  --url https://api.trata.ai/v1/hives/{hive_id} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "hiveType": "WEBSITE",
  "url": "<string>",
  "files": [
    {
      "id": "<string>",
      "orgId": "<string>",
      "fileName": "<string>",
      "fileUrl": "<string>",
      "createdBy": "<string>",
      "createdAt": "2023-11-07T05:31:56Z",
      "updatedBy": "<string>",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ],
  "hiveProps": {},
  "internalProps": {}
}
'
{
  "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"
}

Documentation Index

Fetch the complete documentation index at: https://docs.trata.ai/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
hive_id
string
required

ID of the hive

Body

application/json
​
hiveType
enum<string>
required
Available options:
WEBSITE,
GOOGLE_DOCS,
DOCS,
TRANSCRIPTS
​
url
string | null

URL of the content

Required string length: 1 - 512
​
files
Files · object[] | null

List of files to be referenced for the hive

​
hiveProps
Hiveprops · object

To recursively crawl child pages, add this as props {"crawl_child_pages": true}, "depth": "3"

​
internalProps
Internalprops · object

To add any internal props, add this as props {"last_crawl_time": "123123123123"}

Response

Hive updated successfully

Reference to all business knowledge base will be stored in Hive

​
content
HiveContent · object
required
​
status
string
required
​
id
string
​
orgId
string
​
createdBy
string
​
createdAt
string<date-time>
​
updatedBy
string
​
updatedAt
string<date-time>