Articles

Artiklar är byggstenarna i din AI Agents Knowledge Base. Varje artikel representerar en del kunskap — en hjälpsida, FAQ-post, produktbeskrivning eller vilket innehåll som helst som din AI bör känna till.

Det finns tre artikeltyper: Articles (fullständiga dokument med titel och brödtext), Paragraphs (korta fristående textposter) och URL articles (skapas automatiskt vid import av webbinnehåll). Du kan skapa artiklar manuellt via API:et, importera dem från webbplatser med Import External Content, ladda upp filer via File Upload eller synkronisera från Intercom.

Efter att du skapat eller uppdaterat artiklar, kom ihåg att träna om Knowledge Base för att ändringarna ska få effekt.

Create Article

Scope: write_all

POST https://app.quickchat.ai/v1/api/knowledge_base/articles/

Request Body

Parameter	Description
content string, required	Artikelinnehåll
type string	"Article" (standard) eller "Paragraph"
title string	Artikeltitel

Artikeltyper

• "Article" — Ett fullständigt knowledge base-dokument med titel och innehåll. Använd för FAQ-poster, hjälpartiklar, produktbeskrivningar.
• "Paragraph" — En kort fristående textpost utan titel. Använd för korta fakta, enradssvar, snabbreferensdata.
• "URL" (skrivskyddad) — Skapas automatiskt när innehåll importeras från en webbplats. Innehåller det skrapade sidinnehållet med käll-URL:en. Kan inte sättas vid skapande.

Shell

curl -X POST https://app.quickchat.ai/v1/api/knowledge_base/articles/ \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "content": "Our return policy allows returns within 30 days.",
  "title": "Return Policy"
}'

Python

import requests

response = requests.post(
    url="https://app.quickchat.ai/v1/api/knowledge_base/articles/",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "content": "Our return policy allows returns within 30 days.",
        "title": "Return Policy",
    },
)
data = response.json()

Response 201 Created

{
  "id": 1234,
  "article_id": "abc-123",
  "type": "Article",
  "title": "Return Policy",
  "description": "",
  "content": "Our return policy allows returns within 30 days.",
  "state": "draft",
  "deploy_state": "draft",
  "version": null,
  "max_available_version": null,
  "url": null,
  "tags": [],
  "created_timestamp": "2026-01-15",
  "last_modified_timestamp": "2026-01-15",
  "downloaded_timestamp": "2026-01-15",
  "last_updated_timestamp": "2026-01-15",
  "last_updated_from_external_source_timestamp": null
}

Field	Description
id integer	Artikelns numeriska ID. Detta är den kanoniska identifieraren som används i alla URL-sökvägar
article_id string	Äldre strängidentifierare. Kan vara tom — använd id i stället
type string	"Article", "Paragraph" eller "URL"
title string	Artikeltitel
description string	Artikelbeskrivning
content string	Artikelinnehåll
deploy_state string	"draft" eller "published" — styr artikelns synlighet
state string	Intern bearbetningsstatus (se notisen nedan)
version integer or null	Aktuellt versionsnummer
max_available_version integer or null	Högsta tillgängliga version
url string or null	Käll-URL (för URL-artiklar)
tags array of strings	Kopplade taggar
created_timestamp string	Skapandedatum
last_modified_timestamp string	Senaste ändringsdatum
downloaded_timestamp string	Nedladdningsdatum
last_updated_timestamp string	Senaste uppdateringsdatum
last_updated_from_external_source_timestamp string or null	Senaste uppdatering från extern källa

Förstå artikelns tillstånd

Artiklar har två tillståndsfält:

• deploy_state: Styr om artikeln är ett "draft" eller "published". Detta är det primära fältet du bör använda för att hantera artikelns synlighet.
• state: Speglar den interna bearbetningsstatusen. För de flesta API-användare kan detta fält ignoreras — det spårar backend-bearbetningssteg och kan visa värden som "done" eller "published".

List Articles

Scope: read_all

GET https://app.quickchat.ai/v1/api/knowledge_base/articles/

Query Parameters

Parameter	Description
limit integer	Objekt per sida
offset integer	Objekt att hoppa över
types string	Filtrera efter typ: Article, Paragraph, URL
tags string	Filtrera efter tagg
url string	Filtrera efter URL
title string	Filtrera efter titel
query string	Sök efter innehåll

Shell

curl 'https://app.quickchat.ai/v1/api/knowledge_base/articles/?limit=10&offset=0' \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api/knowledge_base/articles/",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    params={"limit": 10, "offset": 0},
)
data = response.json()

Response 200 OK

{
  "items": [
    {
      "id": 1234,
      "article_id": "abc-123",
      "type": "Article",
      "title": "Return Policy",
      "description": "",
      "state": "published",
      "deploy_state": "published",
      "version": 1,
      "max_available_version": 1,
      "url": null,
      "tags": ["policies"],
      "created_timestamp": "2026-01-15",
      "last_modified_timestamp": "2026-01-15",
      "downloaded_timestamp": "2026-01-15",
      "last_updated_timestamp": "2026-01-15",
      "last_updated_from_external_source_timestamp": null
    }
  ],
  "offset": 0,
  "limit": 10,
  "count": 1
}

Note

Listsvaret inkluderar inte fältet content. Använd Get Article för att hämta det fullständiga innehållet i en specifik artikel.

Get Article

Scope: read_all

GET https://app.quickchat.ai/v1/api/knowledge_base/articles/{article_id}

Shell

curl https://app.quickchat.ai/v1/api/knowledge_base/articles/1234 \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api/knowledge_base/articles/1234",
    headers={"Authorization": "Bearer <API_TOKEN>"},
)
data = response.json()

Response 200 OK — Returnerar det fullständiga artikelobjektet (samma schema som svaret för Create Article), inklusive fältet content.

Update Article

Scope: write_all

PATCH https://app.quickchat.ai/v1/api/knowledge_base/articles/{article_id}

Request Body

Parameter	Description
content string	Uppdaterat artikelinnehåll
title string	Uppdaterad titel
tags array of strings	Uppdaterade taggar
save_mode string	"draft" (standard) eller "publish"

Caution

Alternativet save_mode: "draft" sätter endast flaggan deploy_state — det förhindrar inte att artikelinnehållet används av AI:n när Knowledge Base väl tränats om. För programmatiska workflows, använd save_mode: "publish" och utlös en omträning när du är redo för att ändringarna ska få effekt.

Shell

curl -X PATCH https://app.quickchat.ai/v1/api/knowledge_base/articles/1234 \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '{
  "title": "Updated Return Policy",
  "content": "Returns accepted within 60 days.",
  "save_mode": "publish"
}'

Python

import requests

response = requests.patch(
    url="https://app.quickchat.ai/v1/api/knowledge_base/articles/1234",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json={
        "title": "Updated Return Policy",
        "content": "Returns accepted within 60 days.",
        "save_mode": "publish",
    },
)
data = response.json()

Response 200 OK — Returnerar det uppdaterade artikelobjektet.

Delete Articles

Ta bort en eller flera artiklar via ID.

Scope: write_all

DELETE https://app.quickchat.ai/v1/api/knowledge_base/articles/

Request Body — JSON-array med artikel-ID:n.

Shell

curl -X DELETE https://app.quickchat.ai/v1/api/knowledge_base/articles/ \
  -H 'Authorization: Bearer <API_TOKEN>' \
  -H 'Content-Type: application/json' \
  -d '[1234, 5678]'

Python

import requests

response = requests.delete(
    url="https://app.quickchat.ai/v1/api/knowledge_base/articles/",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    json=[1234, 5678],
)

Response 200 OK

Search Articles

Sök igenom artikelinnehåll med textmatchning.

Scope: read_all

GET https://app.quickchat.ai/v1/api/knowledge_base/articles/search

Query Parameters

Parameter	Description
query string, required	Sökfråga
is_case_insensitive boolean	Skiftlägesokänslig sökning (standard: true)
with_title_url_and_tags boolean	Inkludera titel/URL/taggar i sökningen (standard: true)
strict_search boolean	Kräv exakt matchning (standard: false)
num_of_display_articles integer	Antal artiklar att visa (standard: 5)
num_of_data_articles integer	Antal artiklar att söka i (standard: 15)

Shell

curl 'https://app.quickchat.ai/v1/api/knowledge_base/articles/search?query=return%20policy' \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api/knowledge_base/articles/search",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    params={"query": "return policy"},
)
data = response.json()

Response 200 OK

{
  "article_snippets": [
    {
      "article_id": 1234,
      "expository_sentence": "Our return policy allows returns within 30 days.",
      "query_words_ids": [
        {"start_char": 4, "end_char": 10, "text": "return"}
      ]
    }
  ],
  "article_snapshots": {
    "items": [],
    "offset": 0,
    "count": 1
  }
}

List Paragraphs

Lista alla artiklar av typen Paragraph. Stycken är korta fristående textposter utan titel — till skillnad från fullständiga Articles som har både en titel och en innehållstext.

Scope: read_all

GET https://app.quickchat.ai/v1/api/knowledge_base/articles/paragraphs

Query Parameters

Parameter	Description
limit integer	Objekt per sida
offset integer	Objekt att hoppa över
query string	Filtrera efter innehåll

Shell

curl 'https://app.quickchat.ai/v1/api/knowledge_base/articles/paragraphs?limit=10' \
  -H 'Authorization: Bearer <API_TOKEN>'

Python

import requests

response = requests.get(
    url="https://app.quickchat.ai/v1/api/knowledge_base/articles/paragraphs",
    headers={"Authorization": "Bearer <API_TOKEN>"},
    params={"limit": 10},
)
data = response.json()

Response 200 OK

{
  "items": [
    {
      "id": 1,
      "content": "Our return policy allows returns within 30 days."
    }
  ],
  "offset": 0,
  "count": 1
}

---