Ajouter des faits de marque
curl --request POST \
--url https://api.athenahq.ai/api/v1/knowledge-base/facts \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"website_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"facts": [
{
"text": "<string>",
"source_url": "<string>",
"pillar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"match_token": "<string>",
"decisions": [
{
"claim_id": "<string>",
"text": "<string>"
}
],
"save_submitted": true
}
'import requests
url = "https://api.athenahq.ai/api/v1/knowledge-base/facts"
payload = {
"website_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"facts": [
{
"text": "<string>",
"source_url": "<string>",
"pillar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"match_token": "<string>",
"decisions": [
{
"claim_id": "<string>",
"text": "<string>"
}
],
"save_submitted": True
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
website_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
facts: [
{
text: '<string>',
source_url: '<string>',
pillar_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
}
],
match_token: '<string>',
decisions: [{claim_id: '<string>', text: '<string>'}],
save_submitted: true
})
};
fetch('https://api.athenahq.ai/api/v1/knowledge-base/facts', 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.athenahq.ai/api/v1/knowledge-base/facts",
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([
'website_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'facts' => [
[
'text' => '<string>',
'source_url' => '<string>',
'pillar_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]
],
'match_token' => '<string>',
'decisions' => [
[
'claim_id' => '<string>',
'text' => '<string>'
]
],
'save_submitted' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$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.athenahq.ai/api/v1/knowledge-base/facts"
payload := strings.NewReader("{\n \"website_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"facts\": [\n {\n \"text\": \"<string>\",\n \"source_url\": \"<string>\",\n \"pillar_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n }\n ],\n \"match_token\": \"<string>\",\n \"decisions\": [\n {\n \"claim_id\": \"<string>\",\n \"text\": \"<string>\"\n }\n ],\n \"save_submitted\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
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.athenahq.ai/api/v1/knowledge-base/facts")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"website_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"facts\": [\n {\n \"text\": \"<string>\",\n \"source_url\": \"<string>\",\n \"pillar_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n }\n ],\n \"match_token\": \"<string>\",\n \"decisions\": [\n {\n \"claim_id\": \"<string>\",\n \"text\": \"<string>\"\n }\n ],\n \"save_submitted\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.athenahq.ai/api/v1/knowledge-base/facts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"website_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"facts\": [\n {\n \"text\": \"<string>\",\n \"source_url\": \"<string>\",\n \"pillar_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n }\n ],\n \"match_token\": \"<string>\",\n \"decisions\": [\n {\n \"claim_id\": \"<string>\",\n \"text\": \"<string>\"\n }\n ],\n \"save_submitted\": true\n}"
response = http.request(request)
puts response.read_body{
"outcomes": [
{
"index": 123,
"outcome": "approved",
"fact_id": "<string>",
"pillar_id": "<string>",
"matches": [
{
"id": "<string>",
"text": "<string>",
"status": "pending",
"source_type": "research",
"source_url": "<string>",
"first_party": true,
"pillar_id": "<string>",
"pillar_name": "<string>",
"created_at": "2023-11-07T05:31:56Z"
}
]
}
],
"match_token": "<string>",
"resolved": {
"approved_fact_ids": [
"<string>"
],
"pending_fact_ids": [
"<string>"
],
"removed_fact_ids": [
"<string>"
]
}
}Base de connaissances
Ajouter des faits de marque
Ajoute 1 à 50 faits à la base du site. Chaque fait suit le pipeline complet : déduplication, approbation et attribution de pilier. Aucune approbation forcée ; entrées déclaratives (texte, source et pilier facultatifs), un résultat par fait. Sans pillar_id, orientation automatique pouvant rester non classée. Un fait similaire à un existant n’est pas ajouté : duplicate liste les correspondances dans matches et renvoie match_token. Résolvez par un deuxième appel avec mêmes faits, match_token, décision par correspondance et save_submitted. Clé administrateur du site requise. Disponible aussi comme MCP add_brand_facts.
POST
/
api
/
v1
/
knowledge-base
/
facts
Ajouter des faits de marque
curl --request POST \
--url https://api.athenahq.ai/api/v1/knowledge-base/facts \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"website_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"facts": [
{
"text": "<string>",
"source_url": "<string>",
"pillar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"match_token": "<string>",
"decisions": [
{
"claim_id": "<string>",
"text": "<string>"
}
],
"save_submitted": true
}
'import requests
url = "https://api.athenahq.ai/api/v1/knowledge-base/facts"
payload = {
"website_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"facts": [
{
"text": "<string>",
"source_url": "<string>",
"pillar_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
}
],
"match_token": "<string>",
"decisions": [
{
"claim_id": "<string>",
"text": "<string>"
}
],
"save_submitted": True
}
headers = {
"x-api-key": "<api-key>",
"Content-Type": "application/json"
}
response = requests.post(url, json=payload, headers=headers)
print(response.text)const options = {
method: 'POST',
headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
body: JSON.stringify({
website_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
facts: [
{
text: '<string>',
source_url: '<string>',
pillar_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a'
}
],
match_token: '<string>',
decisions: [{claim_id: '<string>', text: '<string>'}],
save_submitted: true
})
};
fetch('https://api.athenahq.ai/api/v1/knowledge-base/facts', 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.athenahq.ai/api/v1/knowledge-base/facts",
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([
'website_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
'facts' => [
[
'text' => '<string>',
'source_url' => '<string>',
'pillar_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a'
]
],
'match_token' => '<string>',
'decisions' => [
[
'claim_id' => '<string>',
'text' => '<string>'
]
],
'save_submitted' => true
]),
CURLOPT_HTTPHEADER => [
"Content-Type: application/json",
"x-api-key: <api-key>"
],
]);
$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.athenahq.ai/api/v1/knowledge-base/facts"
payload := strings.NewReader("{\n \"website_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"facts\": [\n {\n \"text\": \"<string>\",\n \"source_url\": \"<string>\",\n \"pillar_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n }\n ],\n \"match_token\": \"<string>\",\n \"decisions\": [\n {\n \"claim_id\": \"<string>\",\n \"text\": \"<string>\"\n }\n ],\n \"save_submitted\": true\n}")
req, _ := http.NewRequest("POST", url, payload)
req.Header.Add("x-api-key", "<api-key>")
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.athenahq.ai/api/v1/knowledge-base/facts")
.header("x-api-key", "<api-key>")
.header("Content-Type", "application/json")
.body("{\n \"website_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"facts\": [\n {\n \"text\": \"<string>\",\n \"source_url\": \"<string>\",\n \"pillar_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n }\n ],\n \"match_token\": \"<string>\",\n \"decisions\": [\n {\n \"claim_id\": \"<string>\",\n \"text\": \"<string>\"\n }\n ],\n \"save_submitted\": true\n}")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.athenahq.ai/api/v1/knowledge-base/facts")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Post.new(url)
request["x-api-key"] = '<api-key>'
request["Content-Type"] = 'application/json'
request.body = "{\n \"website_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n \"facts\": [\n {\n \"text\": \"<string>\",\n \"source_url\": \"<string>\",\n \"pillar_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\"\n }\n ],\n \"match_token\": \"<string>\",\n \"decisions\": [\n {\n \"claim_id\": \"<string>\",\n \"text\": \"<string>\"\n }\n ],\n \"save_submitted\": true\n}"
response = http.request(request)
puts response.read_body{
"outcomes": [
{
"index": 123,
"outcome": "approved",
"fact_id": "<string>",
"pillar_id": "<string>",
"matches": [
{
"id": "<string>",
"text": "<string>",
"status": "pending",
"source_type": "research",
"source_url": "<string>",
"first_party": true,
"pillar_id": "<string>",
"pillar_name": "<string>",
"created_at": "2023-11-07T05:31:56Z"
}
]
}
],
"match_token": "<string>",
"resolved": {
"approved_fact_ids": [
"<string>"
],
"pending_fact_ids": [
"<string>"
],
"removed_fact_ids": [
"<string>"
]
}
}Corps
application/json
Site dont alimenter la base de connaissances.
Faits à ingérer. Aucun champ de statut ou d’approbation : le pipeline décide.
Required array length:
1 - 50 elementsShow child attributes
Show child attributes
Deuxième appel uniquement : le match_token d’une réponse ayant répertorié des matches. Envoyez-le avec les mêmes faits non ajoutés, une décision par correspondance répertoriée et save_submitted.
Deuxième appel uniquement : une décision pour chaque fait de matches, et aucun autre. approve conserve : un fait approuvé le reste et rejoint le pilier des faits s’il n’en a pas ; un fait en attente n’est approuvé que selon les règles d’un nouveau fait (source tierce ou affirmation concurrentielle le garde en attente). Avec text, remplace la formulation, dont le statut suit les mêmes règles. delete rejette un fait en attente ou archive un fait approuvé.
Maximum array length:
500Show child attributes
Show child attributes
Deuxième appel uniquement : true ajoute les faits tels qu’ils sont rédigés, sans autre vérification de similarité, via les étapes d’approbation habituelles ; false applique uniquement les décisions. Les décisions et les faits ajoutés sont enregistrés ensemble ou pas du tout.
Réponse
Faits intégrés ; un résultat par fait, aligné par index avec la requête
Show child attributes
Show child attributes
Présent si un résultat contient matches. Renvoyez-le au deuxième appel.
Au deuxième appel : faits approuvés par les décisions, faits dont les règles ont maintenu l’attente (nouvelle formulation : nouvel ID), et faits rejetés/archivés.
Show child attributes
Show child attributes
Cette page vous a-t-elle été utile ?