Get converter status

Checks whether the document converter binary can be resolved. Requires L0 authorization.

GET /api/v1/knowledge/converter/status

Get converter binary status

cURL

curl --request GET \
  --url http://127.0.0.1:4000/api/v1/knowledge/converter/status \
  --header 'Authorization: Bearer <token>'

200

{
  "installed": true,
  "path": "<string>"
}

This endpoint verifies whether the Knowledge converter binary is available to the server runtime.

The converter is familyco-py, downloaded from:

• Repository: omaicode/familyco-py
• Release assets: latest release downloads

About familyco-py:

• It is a Python toolkit CLI used by FamilyCo for document preprocessing.
• Its current core module is doc-convert (Docling-based conversion and OCR).
• FamilyCo uses the converter output as the input for chunking and knowledge indexing.

Expected response shape:

{
	"installed": true,
	"path": "/absolute/path/to/familyco-py"
}

Authorizations

Authorization · string · header · required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

200 - application/json

Converter status

installed · boolean · required

path · string | null · required