Knowledge

Knowledge endpoints.

This page is GENERATED from the OpenAPI spec (openapi.yaml) — it can never drift from the served API. Set UR_BASE_URL (required: your gateway’s URL) and UR_API_KEY (an ur_sk_* key); secrets are always the $UR_API_KEY placeholder.

Search company knowledge

GET /v1/knowledge

Workspace members or config:read/config:write keys. Knowledge and corrections consent required; unavailable content is omitted. Lessons include stored text and atomic metadata; citations expose metadata only. Facts expose allowlisted derived statistics and structured scope, never arbitrary bodies. Current candidates are not active or proven. No training or provider calls. Existing consent and erasure rules apply. Evidence availability refers to retained metadata, not raw source bodies; correction-body TTL does not expire derived lessons. snapshot_at is an observation time, not a durable database snapshot. Requires API-key scope: config:read or config:write.

Auth: API key (Authorization: Bearer ur_sk_…).

curl -sS -X GET "$UR_BASE_URL/v1/knowledge" \
  -H "Authorization: Bearer $UR_API_KEY"

Export retained company knowledge content

GET /v1/knowledge/export

Session-only owner/admin with 2FA and flywheel.export permission. Requires knowledge, corrections and training_export consent. Audited explicit content export ur.company_knowledge/v1; preserved /v1/flywheel/knowledge/export remains the metadata bundle. Normalized selection filters are included in the hash and manifest; complete is true only when this page contains every match of that selection, truncated includes omitted preceding pages. Resume with next_cursor; clocks and cursor excluded from content_hash. Exclusions explicitly identify unsupported/raw content. No import, activation or owned model weights.

Auth: Session cookie + workspace RBAC.

curl -sS -X GET "$UR_BASE_URL/v1/knowledge/export" \
  -H "Cookie: better-auth.session_token=$UR_SESSION"

Read one company knowledge item

GET /v1/knowledge/{id}

Workspace members or config:read/config:write keys. Knowledge and corrections consent required; unavailable content is omitted. Lessons include stored text and atomic metadata; citations expose metadata only. Facts expose allowlisted derived statistics and structured scope, never arbitrary bodies. Current candidates are not active or proven. No training or provider calls. Existing consent and erasure rules apply. Evidence availability refers to retained metadata, not raw source bodies; correction-body TTL does not expire derived lessons. snapshot_at is an observation time, not a durable database snapshot. IDs: fact:<fact_id> or lesson:<version_id>:<lesson_id>. Unknown, foreign or erased items return 404. Requires API-key scope: config:read or config:write.

Auth: API key (Authorization: Bearer ur_sk_…).

curl -sS -X GET "$UR_BASE_URL/v1/knowledge/req_0000000000000000" \
  -H "Authorization: Bearer $UR_API_KEY"