---
title: "Create Training Text"
method: POST
path: "/chatbots/{chatbot_id}/training-texts"
tags: ["Chatbot Text Snippets"]
---

# Create Training Text

`POST /chatbots/{chatbot_id}/training-texts`

## Request

- Base URL: `https://app.boei.help/api/v1`
- URL: `https://app.boei.help/api/v1/chatbots/{chatbot_id}/training-texts`
- Auth: HTTP bearer

Create a new training text piece for a chatbot. Content is automatically chunked and embedded for AI search.

NOTE: Processing runs in the background; the chatbot can use the new text shortly after status becomes completed (see training.get).

## Request body

- object
  - `title` string, required: Short internal title.
  - `content` string, required: The training content.
  - `tag_slugs` string[]: Optional tag slugs to attach.
  - `tag_ids` string[]: Must be a valid UUID.
  - `sort_order` integer, nullable: Optional display order.

## Response `201`

- object
  - `training_text` object
    - `id` string
    - `title` string
    - `content` string
    - `char_count` integer
    - `status` string
    - `sort_order` integer
    - `tags` object[]
      - `id` string
      - `tag_slug` string
      - `label` string
    - `created_at` string
    - `updated_at` string
  - `usage` object
    - `text_chars_used` integer
    - `text_chars_limit` integer
    - `training_pages_used` integer
    - `training_pages_limit` integer
  - `message` string

## Other responses

- `403`

---

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