FusionDesk Articles API — Manage Knowledge Base Articles

The Articles API allows you to programmatically manage your help center resources and Knowledge Base content. These articles are used as direct context by the AI Agent to formulate RAG-based auto-responses.

GET /articles

Retrieve a list of articles.

integer

default:"50"

Number of articles to return per page. Maximum value is 50.

curl -X GET "https://api.fusiondesk.in/v1/articles?limit=10" \
  -H "Authorization: Bearer fd_live_xxxxxxxxxxxxxxxxxxxx"

[
  {
    "id": "art_12345",
    "name": "How to Reset Your Password",
    "content": "To reset your password, click the 'Forgot Password' link on the login page and enter your registered email address.",
    "organizationId": "org_54321",
    "published": true,
    "created": "2026-07-27T21:00:00.000Z",
    "modified": "2026-07-27T21:00:00.000Z"
  }
]

GET /articles/search

Search for published articles using text queries.

string

required

The text query to search.

integer

default:"50"

The maximum number of hits to return.

curl -X GET "https://api.fusiondesk.in/v1/articles/search?q=password" \
  -H "Authorization: Bearer fd_live_xxxxxxxxxxxxxxxxxxxx"

[
  {
    "id": "art_12345",
    "name": "How to Reset Your Password",
    "content": "To reset your password, click the 'Forgot Password' link...",
    "organizationId": "org_54321",
    "published": true
  }
]

GET /articles/{id}

Retrieve details for a single article.

string

required

The unique ID of the article.

curl -X GET "https://api.fusiondesk.in/v1/articles/art_12345" \
  -H "Authorization: Bearer fd_live_xxxxxxxxxxxxxxxxxxxx"

{
  "id": "art_12345",
  "name": "How to Reset Your Password",
  "content": "To reset your password, click the 'Forgot Password' link on the login page and enter your registered email address.",
  "organizationId": "org_54321",
  "published": true,
  "created": "2026-07-27T21:00:00.000Z",
  "modified": "2026-07-27T21:00:00.000Z"
}

POST /articles

Create a new article.

string

required

The title of the article.

string

required

The markdown content of the article.

curl -X POST "https://api.fusiondesk.in/v1/articles" \
  -H "Authorization: Bearer fd_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "How to Reset Your Password",
    "content": "To reset your password, click the Forgot Password link."
  }'

{
  "id": "art_12345",
  "name": "How to Reset Your Password",
  "content": "To reset your password, click the Forgot Password link.",
  "created": "2026-07-28T10:00:00.000Z",
  "modified": "2026-07-28T10:00:00.000Z"
}

PUT /articles/{id}

Update an existing article.

string

required

The unique ID of the article.

string

The title of the article.

string

The markdown content of the article.

curl -X PUT "https://api.fusiondesk.in/v1/articles/art_12345" \
  -H "Authorization: Bearer fd_live_xxxxxxxxxxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Updated Password Reset Guide"
  }'

{
  "id": "art_12345",
  "name": "Updated Password Reset Guide",
  "content": "To reset your password, click the Forgot Password link.",
  "created": "2026-07-28T10:00:00.000Z",
  "modified": "2026-07-28T10:05:00.000Z"
}

DELETE /articles/{id}

Delete an article record permanently.

string

required

The unique ID of the article.

curl -X DELETE "https://api.fusiondesk.in/v1/articles/art_12345" \
  -H "Authorization: Bearer fd_live_xxxxxxxxxxxxxxxxxxxx"

A successful deletion returns 204 No Content with an empty response body.

Overview

Endpoints

FusionDesk Articles API — Manage Knowledge Base Articles

GET /articles

GET /articles/search

GET /articles/{id}

POST /articles

PUT /articles/{id}

DELETE /articles/{id}

​GET /articles

​GET /articles/search

​GET /articles/{id}

​POST /articles

​PUT /articles/{id}

​DELETE /articles/{id}

GET /articles

GET /articles/search

GET /articles/{id}

POST /articles

PUT /articles/{id}

DELETE /articles/{id}