Skip to main content
PUT
/
v2
/
hc-articles
/
{id}
/
public
Update article
curl --request PUT \
  --url https://api-prod.usefini.com/v2/hc-articles/{id}/public \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: <content-type>' \
  --data '
{
  "title": "<string>",
  "mainKnowledge": "<string>",
  "agentInstruction": "<string>",
  "questions": [
    {}
  ],
  "keywords": [
    {}
  ],
  "escalation": true,
  "active": true,
  "public": true
}
'
Use this route to change the content or metadata of an existing article.

​
Headers

​
Authorization
string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs write scope.
​
Content-Type
string
required
application/json

​
Path parameters

​
id
string
required
Article ID to update.

​
Body parameters

​
title
string
required
Updated article title.
​
mainKnowledge
string
required
Updated main knowledge body.
​
agentInstruction
string
required
Updated instructions the agent should apply when using this article.
​
questions
array
required
Updated question prompts for the article.
​
keywords
array
required
Updated keywords for the article.
​
escalation
boolean
required
Updated escalation flag.
​
active
boolean
Updated active state.
​
public
boolean
Updated help-center visibility.
This update route does not accept parentFolderId, isDraft, or origin. Use Move article to change folders.

​
Response

Returns the full updated article object. See Manage knowledge for the shared article fields.
The response includes the article’s latest version after the update is applied.

​
Errors

The request body is malformed or one of the required arrays is empty.
The API key is missing, malformed, revoked, or invalid.
The API key does not include the write scope.
The article does not exist in the workspace.