Skip to main content
POST
/
v2
/
knowledge
/
public
/
jobs
/
status
curl --request POST \
  --url 'https://api-prod.usefini.com/v2/knowledge/public/jobs/status' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "jobIds": [
      "4cfcf2cc-7a06-4de2-b460-5b991fe6236a"
    ]
  }'

{
  "jobs": [
    {
      "id": "4cfcf2cc-7a06-4de2-b460-5b991fe6236a",
      "jobStatus": "COMPLETED",
      "createdAt": "2026-06-11T12:00:00.000Z",
      "startedAt": "2026-06-11T12:00:01.000Z",
      "completedAt": "2026-06-11T12:00:05.000Z",
      "hcArticleId": "7f5392e5-dc7d-4558-8860-cf3ea4b32f94"
    }
  ]
}
Use this route to poll background jobs queued by Generate knowledge or Bulk generate knowledge.

​
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

​
jobIds
array
required
Background job IDs to inspect.

​
Response

​
jobs
array
Status rows for the requested jobs.
curl --request POST \
  --url 'https://api-prod.usefini.com/v2/knowledge/public/jobs/status' \
  --header 'Authorization: Bearer fini_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "jobIds": [
      "4cfcf2cc-7a06-4de2-b460-5b991fe6236a"
    ]
  }'

{
  "jobs": [
    {
      "id": "4cfcf2cc-7a06-4de2-b460-5b991fe6236a",
      "jobStatus": "COMPLETED",
      "createdAt": "2026-06-11T12:00:00.000Z",
      "startedAt": "2026-06-11T12:00:01.000Z",
      "completedAt": "2026-06-11T12:00:05.000Z",
      "hcArticleId": "7f5392e5-dc7d-4558-8860-cf3ea4b32f94"
    }
  ]
}

​
Errors

The request body is malformed or jobIds is missing or empty.
The API key is missing, malformed, revoked, or invalid.
The API key does not include the read scope.
One or more job IDs do not exist, are inaccessible from this workspace, or are not knowledge-generation jobs.
Fini failed while reading job status. Retry once, then narrow the request to isolate the failing job ID.