---
title: "Create or (when id is provided) update an agent knowledge base entry (knowledge:write)."
method: POST
path: "/v1/knowledge"
---

# Create or (when id is provided) update an agent knowledge base entry (knowledge:write).

`POST /v1/knowledge`

## Request

- Base URL: `https://www.kaicalls.com/api`
- URL: `https://www.kaicalls.com/api/v1/knowledge`
- Auth: HTTP bearer

## Request body

- KnowledgeUpsert: business_id is required for both create and update. Omit id to create; retain the returned knowledge.id and send it to update that row. Title is not an upsert key.
  - `id` string, uuid, required
  - `business_id` string, uuid, required
  - `title` string
  - `content` string
  - `content_type` string
  - `category` string, nullable
  - `tags` string[], nullable

## Response `200`

Knowledge item updated

## Other responses

- `201`: Knowledge item created

---

[API](https://skmtc.dev/kaicalls/apis/kaicalls-public-api.md) · [All operations](https://skmtc.dev/kaicalls/apis/kaicalls-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kaicalls/apis/kaicalls-public-api/revisions/e607fc6cf36e?raw)