Skip to main content
POST
/
v2
/
hc-articles
/
ids
/
public
curl --request POST \
  --url 'https://api-prod.usefini.com/v2/hc-articles/ids/public' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "articleIds": ["7f5392e5-dc7d-4558-8860-cf3ea4b32f94"]
  }'
Use this route when you want direct lookup by one or more article IDs.
If you want to fetch a single article by ID, send a single-item articleIds array. There is no workspace-API-key GET /v2/hc-articles/:id/public route in the current controller.

Headers

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

Body parameters

articleIds
array
required
Article IDs to fetch in one request.
curl --request POST \
  --url 'https://api-prod.usefini.com/v2/hc-articles/ids/public' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "articleIds": ["7f5392e5-dc7d-4558-8860-cf3ea4b32f94"]
  }'

Response

Returns an array of the article objects that were found in the workspace. Each item uses the shared object defined in Manage knowledge.
The current route returns the articles it finds. It does not reject the request just because some requested IDs are missing.

Errors

The request body is malformed or articleIds is missing.
The API key is missing, malformed, revoked, or invalid.
The API key does not include the read scope.