Añadir datos de marca
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 conocimientos
Añadir datos de marca
Añade datos de marca en lote a la base de conocimientos de un sitio (1-50 por llamada). Cada dato pasa por deduplicación, controles de aprobación y asignación a pilares; no se puede forzar la aprobación. Las entradas son declarativas (texto, URL opcional y pilar fijado opcional) y la respuesta indica un resultado por dato. Sin pillar_id se asignan automáticamente y pueden quedar sin pilar. Si ya hay datos similares, no se añade: devuelve duplicate, los lista en matches y aporta match_token. Resuelve con una segunda llamada con los mismos datos, el match_token, una decisión por coincidencia y save_submitted. Requiere una clave de administrador del sitio. También disponible como herramienta MCP add_brand_facts.
POST
/
api
/
v1
/
knowledge-base
/
facts
Añadir datos de marca
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>"
]
}
}Cuerpo
application/json
Sitio web a cuya base de conocimientos se añadirán los datos.
Datos que se ingerirán. No existe ningún campo de estado o aprobación: lo decide el proceso.
Required array length:
1 - 50 elementsShow child attributes
Show child attributes
Solo en la segunda llamada: el match_token de una respuesta que incluía matches. Envíalo con los mismos datos no añadidos, una decisión por cada coincidencia y save_submitted.
Solo en la segunda llamada: una decisión por cada dato de matches, y solo esos. approve conserva el dato: si ya está aprobado, sigue así y se asigna al pilar de los datos si no tiene; uno pendiente solo se aprueba si las reglas habituales admiten texto y fuente (una fuente de terceros o afirmación competitiva lo mantiene pendiente). Con text, se sustituye por esa redacción y las mismas reglas deciden su estado. delete rechaza uno pendiente o archiva uno aprobado.
Maximum array length:
500Show child attributes
Show child attributes
Solo en la segunda llamada: true añade los datos tal como están escritos, sin otra comprobación de similitud y con los controles habituales de aprobación; false solo aplica las decisiones. Decisiones y datos se escriben conjuntamente o no se escribe nada.
Respuesta
Datos ingeridos; un resultado por dato, en el mismo orden que la solicitud
Show child attributes
Show child attributes
Aparece cuando algún resultado incluye matches. Devuélvelo en la segunda llamada.
Presente en la segunda llamada: datos listados que las decisiones han aprobado, los aprobados que las reglas mantienen pendientes (un dato con nueva redacción tiene un ID nuevo) y los rechazados o archivados.
Show child attributes
Show child attributes
¿Esta página le ayudó?