API Reference knowledge-base

Lint the knowledge base

POST/projects/{project_id}/workspace/okf/lint

Health report — broken links, orphan concepts, missing types or citations, duplicate titles.

Request

curl -X POST "$ALLYBUILD_API_URL/projects/$PROJECT_ID/workspace/okf/lint" \
  -H "Authorization: Bearer $TASK_JWT" \
  -H "Content-Type: application/json"
  -d '{}'

Response

[
  {
    "issue_type": "broken_link",
    "concept_id": "policies/refunds",
    "message": "links to missing concept approval-gates.md"
  }
]