Skip to main content
GET
/
v2
/
hc-articles
/
public
curl --request GET \
  --url 'https://api-prod.usefini.com/v2/hc-articles/public?type=live&from=2026-06-01T00:00:00.000Z' \
  --header 'Authorization: Bearer fini_your_api_key'
Use this route to read the current articles in the workspace.

Headers

Authorization
string
required
Bearer token containing your Fini workspace API key. Format: Bearer fini_... The key needs read scope.

Query parameters

type
string
Optional filter. Allowed values: live and draft. If omitted, the route returns both live and draft articles.
from
string
Optional lower bound on updatedAt. In practice this is usually an ISO 8601 timestamp.
curl --request GET \
  --url 'https://api-prod.usefini.com/v2/hc-articles/public?type=live&from=2026-06-01T00:00:00.000Z' \
  --header 'Authorization: Bearer fini_your_api_key'

Response

Returns an array of article objects sorted by updatedAt descending. Each item uses the shared object defined in Manage knowledge, including fields such as id, title, mainKnowledge, parentFolderId, timestamps, and optional draft metadata.
If you omit type, the array can include both live articles and draft articles.

Errors

The query parameters are malformed or type is not one of the allowed values.
The API key is missing, malformed, revoked, or invalid.
The API key does not include the read scope.