---
title: "Create a knowledge document"
method: POST
path: "/v1/knowledge"
tags: ["Knowledge"]
---

# Create a knowledge document

`POST /v1/knowledge`

## Request

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

`{ title, body, inbox_id? }`. Body up to 200,000 characters of plain text or markdown. No `inbox_id` means all inboxes. 201 with the document.

Permission: `knowledge:write`.

## Request body

- object
  - `title` string, required
  - `body` string, required
  - `inbox_id` string, uuid, nullable

## Response `200`

OK

- object

## Other responses

- `4XX`: Error
- `5XX`: Error

---

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