Knowledge

The knowledge base gives Strix org-specific context — documents, policies, and per-repository profiles — that informs how scans and reviews are performed.

Documents

List documents:

curl -X GET "https://app.strix.ai/api/v1/knowledge" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"

Required scope: knowledge:read Create a document:

curl -X POST "https://app.strix.ai/api/v1/knowledge" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Auth architecture",
    "content": "We use WorkOS for SSO and short-lived JWTs...",
    "tags": ["auth", "architecture"]
  }'

Required scope: knowledge:write Update or delete a document:

curl -X PATCH "https://app.strix.ai/api/v1/knowledge/<DOCUMENT_ID>" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"content": "Updated content"}'

curl -X DELETE "https://app.strix.ai/api/v1/knowledge/<DOCUMENT_ID>" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"

Required scope: knowledge:write

Query the knowledge base

Search across knowledge for relevant context:

curl -X GET "https://app.strix.ai/api/v1/knowledge/query?q=authentication" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"

Required scope: knowledge:read

Policies

List policies:

curl -X GET "https://app.strix.ai/api/v1/knowledge/policies" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"

Required scope: knowledge:read Create or update a policy (upsert by key):

curl -X POST "https://app.strix.ai/api/v1/knowledge/policies" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
    "key": "out-of-scope",
    "content": "Never test the billing provider endpoints.",
    "enabled": true
  }'

Delete a policy:

curl -X DELETE "https://app.strix.ai/api/v1/knowledge/policies/<POLICY_KEY>" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"

Required scope: knowledge:write

Repository profiles

List repository knowledge profiles and their entries:

curl -X GET "https://app.strix.ai/api/v1/knowledge/repos" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"

curl -X GET "https://app.strix.ai/api/v1/knowledge/repos/<REPO>/entries" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"

Required scope: knowledge:read Update a repository profile:

curl -X PATCH "https://app.strix.ai/api/v1/knowledge/repos/<REPO>/profile" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"content": "This service handles PCI data."}'

Required scope: knowledge:write

Settings

curl -X GET "https://app.strix.ai/api/v1/knowledge/settings" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"

curl -X PATCH "https://app.strix.ai/api/v1/knowledge/settings" \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"org_knowledge_enabled": true}'

Required scopes: knowledge:read (GET), knowledge:write (PATCH)

Getting Started

Guides

Documents

Query the knowledge base

Policies

Repository profiles

Settings

​Documents

​Query the knowledge base

​Policies

​Repository profiles

​Settings

Documents

Query the knowledge base

Policies

Repository profiles

Settings