Get the knowledge base
curl --request GET \
--url https://api-prod.heliyos.ai/v1/auth/organizations/current \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/auth/organizations/current', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api-prod.heliyos.ai/v1/auth/organizations/current"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"meta": {
"message": "Organization Successfully Fetched."
},
"data": {
"id": "66a0f1e2d3c4b5a697887766",
"_id": "66a0f1e2d3c4b5a697887766",
"name": "Northwind Traders",
"website": "https://northwind.example.com",
"industry": "Wholesale distribution",
"timezone": "America/New_York",
"businessContext": "Northwind Traders supplies specialty food and beverage products to independent grocers and cafes across North America.",
"knowledgeBase": {
"productsInformation": "Wholesale catalogue of 1,200 specialty foods, with next-day delivery in 40 metro areas.",
"painPoints": "Independent grocers lose margin to stockouts and juggle too many small suppliers.",
"valueProposition": "One supplier, one invoice and next-day restocking for the long tail of the shelf.",
"qualificationCriteria": "Independent grocers or cafe groups with 3 or more locations and a buyer we can reach.",
"entries": [
{
"label": "Pricing",
"content": "Volume pricing starts at $5,000 a month. Net 30 terms after the first order."
},
{
"label": "Competitors",
"content": "Regional distributors and direct-from-brand programs. We win on breadth and delivery speed."
}
]
},
"createdAt": "2024-07-24T09:15:00.000Z",
"updatedAt": "2026-11-02T14:30:00.000Z"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}Knowledge base
Get the knowledge base
Returns the workspace your API key belongs to with its knowledge base: the business context, the four fixed texts and the custom entries, plus the workspace’s profile (name, website, industry, time zone and address).
Texts come back in full. Read this before you call Update the knowledge base, because that call replaces the knowledge base whole.
To list the files your workers read, call List files with kind=knowledge_base.
GET
/
v1
/
auth
/
organizations
/
current
Get the knowledge base
curl --request GET \
--url https://api-prod.heliyos.ai/v1/auth/organizations/current \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api-prod.heliyos.ai/v1/auth/organizations/current', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api-prod.heliyos.ai/v1/auth/organizations/current"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"meta": {
"message": "Organization Successfully Fetched."
},
"data": {
"id": "66a0f1e2d3c4b5a697887766",
"_id": "66a0f1e2d3c4b5a697887766",
"name": "Northwind Traders",
"website": "https://northwind.example.com",
"industry": "Wholesale distribution",
"timezone": "America/New_York",
"businessContext": "Northwind Traders supplies specialty food and beverage products to independent grocers and cafes across North America.",
"knowledgeBase": {
"productsInformation": "Wholesale catalogue of 1,200 specialty foods, with next-day delivery in 40 metro areas.",
"painPoints": "Independent grocers lose margin to stockouts and juggle too many small suppliers.",
"valueProposition": "One supplier, one invoice and next-day restocking for the long tail of the shelf.",
"qualificationCriteria": "Independent grocers or cafe groups with 3 or more locations and a buyer we can reach.",
"entries": [
{
"label": "Pricing",
"content": "Volume pricing starts at $5,000 a month. Net 30 terms after the first order."
},
{
"label": "Competitors",
"content": "Regional distributors and direct-from-brand programs. We win on breadth and delivery speed."
}
]
},
"createdAt": "2024-07-24T09:15:00.000Z",
"updatedAt": "2026-11-02T14:30:00.000Z"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}{
"message": "<string>",
"error": {
"code": "VALIDATION_FAILED",
"message": "<string>",
"details": "<unknown>"
}
}In the Heliyos MCP server:
heliyos_knowledge_entries_delete, heliyos_knowledge_entries_set, heliyos_knowledge_get, heliyos_knowledge_update.Authorizations
A workspace API key, sent as Authorization: Bearer heliyos_.... Create one in Heliyos under Settings → API keys. A key acts as a workspace admin in the one workspace it was created in.
Was this page helpful?

