BOboei
Chatbot Text Snippets

Create Training Text

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).

post/chatbots/{chatbot_id}/training-texts

Request

  • Base URL
    https://app.boei.help/api/v1
  • Auth
    HTTP bearer

Request body

titlestring required

Short internal title.

contentstring required

The training content.

tag_slugsstring[]

Optional tag slugs to attach.

tag_idsstring[]

Must be a valid UUID.

sort_orderinteger nullable

Optional display order.

Example request

{
  "title": "Bus Schedule",
  "content": "The bus departs every 30 minutes from the main entrance.",
  "tag_slugs": [
    "event-2026"
  ],
  "tag_ids": [
    "6b72fe4a-5b40-307c-bc24-f79acf9a1bb9"
  ]
}

Response

messagestring

Example response

{
  "training_text": {
    "id": "794d9b3b-d68f-498a-bb25-de9689722603",
    "title": "Bus Schedule",
    "content": "The bus departs every 30 minutes...",
    "char_count": 42,
    "status": "processing",
    "sort_order": 0,
    "tags": [
      {
        "id": "uuid",
        "tag_slug": "event-2026",
        "label": "Event 2026"
      }
    ],
    "created_at": "2026-03-13T10:00:00.000000Z",
    "updated_at": "2026-03-13T10:00:00.000000Z"
  },
  "usage": {
    "text_chars_used": 42,
    "text_chars_limit": 1000000,
    "training_pages_used": 5,
    "training_pages_limit": 1000
  },
  "message": "Training text created successfully"
}

Changes

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