List articles

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'

GET

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

string

required

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

Query parameters

string

Optional filter. Allowed values: live and draft. If omitted, the route returns both live and draft articles.

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

400 Bad Request

The query parameters are malformed or type is not one of the allowed values.

401 Unauthorized

The API key is missing, malformed, revoked, or invalid.

403 Forbidden

The API key does not include the read scope.

⌘I

​Headers

​Query parameters

​Response

​Errors

Headers

Query parameters

Response

Errors