facade

Manage Kb

Maintain the knowledge base — the consolidated KB writer.

Actions (id = document UUID):

  • upsert: create or update a document (no id — the payload's name is the upsert key; payload = {name, content, doc_type?, summary?, metadata?}); bulk via items.
  • delete: permanently delete a document. DESTRUCTIVE.
  • reindex: rebuild a document's search index (no payload).

Bulk: delete/reindex take id arrays (server-side loop, per-item status — partial failure reported per item, never silent; max 100). Payloads are validated by the underlying route's schema.

post/api/facade/manage_kb

Request

  • Base URL: https://api.vruum.ai
  • URL: https://api.vruum.ai/api/facade/manage_kb
  • Auth: HTTPBearer (a scheme the document does not define)

Request body

actionstring required

The operation to perform — see the tool description for the action vocabulary and each action's id/payload semantics.

payloadobject nullable

Action-specific fields, validated by the underlying route's own schema (a bad field 422s with that route's precise errors). See the tool description per action.

itemsobject[] nullable

For create-like actions only: an array of per-item payloads processed in order with per-item results (max 100). Mutually exclusive with id and payload.

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.