Knowledge
Create Knowledge
Create a new knowledge entry
If x-knowledge-base-config-id header is provided, uses that specific configuration. Otherwise, uses the account’s default active knowledge base configuration.
POST
/
api
/
v1
/
knowledge
Create Knowledge
curl --request POST \
--url https://api.evoai.app/api/v1/knowledge \
--header 'Content-Type: application/json' \
--data '
{
"title": "<string>",
"content": "<string>",
"client_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"description": "<string>",
"tags": [
"<string>"
],
"metadata": {},
"is_active": true
}
'import requests
url = "https://api.evoai.app/api/v1/knowledge"
payload = {
"title": "<string>",
"content": "<string>",
"client_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"description": "<string>",
"tags": ["<string>"],
"metadata": {},
"is_active": True
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
title: '<string>',
content: '<string>',
client_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
description: '<string>',
tags: ['<string>'],
metadata: {},
is_active: true
})
};
fetch('https://api.evoai.app/api/v1/knowledge', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.evoai.app/api/v1/knowledge",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'title' => '<string>',
'content' => '<string>',
'client_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'description' => '<string>',
'tags' => [
'<string>'
],
'metadata' => [
],
'is_active' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.evoai.app/api/v1/knowledge"
payload := strings.NewReader("{\n \"title\": \"<string>\",\n \"content\": \"<string>\",\n \"client_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"metadata\": {},\n \"is_active\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.evoai.app/api/v1/knowledge")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"<string>\",\n \"content\": \"<string>\",\n \"client_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"metadata\": {},\n \"is_active\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.evoai.app/api/v1/knowledge")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"<string>\",\n \"content\": \"<string>\",\n \"client_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"metadata\": {},\n \"is_active\": true\n}"
response = http.request(request)
puts response.read_body{
"data": "<unknown>",
"meta": "<unknown>",
"success": true,
"message": "<string>"
}{
"success": false,
"error": {
"code": "BAD_REQUEST",
"message": "Invalid input data"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/knowledge",
"method": "POST"
}
}{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or missing authentication token"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/knowledge",
"method": "POST"
}
}{
"success": false,
"error": {
"code": "FORBIDDEN",
"message": "Insufficient permissions to perform this action"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/knowledge",
"method": "POST"
}
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Knowledge base configuration not found"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/knowledge",
"method": "POST"
}
}{
"detail": [
"<unknown>"
]
}{
"success": false,
"error": {
"code": "INTERNAL_SERVER_ERROR",
"message": "An unexpected error occurred"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/knowledge",
"method": "POST"
}
}Cabeçalhos
Corpo
application/json
Schema for creating knowledge entries
Title of the knowledge entry
Content of the knowledge entry
Client ID that owns this knowledge
Description of the knowledge entry
Tags for categorization
Additional metadata
Whether the knowledge entry is active
⌘I
Create Knowledge
curl --request POST \
--url https://api.evoai.app/api/v1/knowledge \
--header 'Content-Type: application/json' \
--data '
{
"title": "<string>",
"content": "<string>",
"client_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"description": "<string>",
"tags": [
"<string>"
],
"metadata": {},
"is_active": true
}
'import requests
url = "https://api.evoai.app/api/v1/knowledge"
payload = {
"title": "<string>",
"content": "<string>",
"client_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"description": "<string>",
"tags": ["<string>"],
"metadata": {},
"is_active": True
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'Content-Type': 'application/json'},
body: JSON.stringify({
title: '<string>',
content: '<string>',
client_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
description: '<string>',
tags: ['<string>'],
metadata: {},
is_active: true
})
};
fetch('https://api.evoai.app/api/v1/knowledge', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.evoai.app/api/v1/knowledge",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "POST",
CURLOPT_POSTFIELDS => json_encode([
'title' => '<string>',
'content' => '<string>',
'client_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'description' => '<string>',
'tags' => [
'<string>'
],
'metadata' => [
],
'is_active' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"strings"
"net/http"
"io"
)
func main() {
url := "https://api.evoai.app/api/v1/knowledge"
payload := strings.NewReader("{\n \"title\": \"<string>\",\n \"content\": \"<string>\",\n \"client_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"metadata\": {},\n \"is_active\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.post("https://api.evoai.app/api/v1/knowledge")
.header("Content-Type", "application/json")
.body("{\n \"title\": \"<string>\",\n \"content\": \"<string>\",\n \"client_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"metadata\": {},\n \"is_active\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.evoai.app/api/v1/knowledge")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["Content-Type"] = 'application/json'
request.body = "{\n \"title\": \"<string>\",\n \"content\": \"<string>\",\n \"client_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"description\": \"<string>\",\n \"tags\": [\n \"<string>\"\n ],\n \"metadata\": {},\n \"is_active\": true\n}"
response = http.request(request)
puts response.read_body{
"data": "<unknown>",
"meta": "<unknown>",
"success": true,
"message": "<string>"
}{
"success": false,
"error": {
"code": "BAD_REQUEST",
"message": "Invalid input data"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/knowledge",
"method": "POST"
}
}{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "Invalid or missing authentication token"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/knowledge",
"method": "POST"
}
}{
"success": false,
"error": {
"code": "FORBIDDEN",
"message": "Insufficient permissions to perform this action"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/knowledge",
"method": "POST"
}
}{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Knowledge base configuration not found"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/knowledge",
"method": "POST"
}
}{
"detail": [
"<unknown>"
]
}{
"success": false,
"error": {
"code": "INTERNAL_SERVER_ERROR",
"message": "An unexpected error occurred"
},
"meta": {
"timestamp": "2024-01-15T10:30:00Z",
"path": "/api/v1/knowledge",
"method": "POST"
}
}