Skip to main content
PUT
Update article
Use this route to change the content or metadata of an existing article.

Headers

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

Path parameters

string
required
Article ID to update.

Body parameters

string
required
Updated article title.
string
required
Updated main knowledge body.
string
required
Updated instructions the agent should apply when using this article.
array
required
Updated question prompts for the article.
array
required
Updated keywords for the article.
boolean
required
Updated escalation flag.
boolean
Updated active state.
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.