Add Text Content

Add Text Content allows you to add custom text content and link it with a chatbot as a knowledge asset.

This endpoint is used when you want to provide manually written content, FAQs, policy text, product details, business information, support instructions, or other plain text knowledge to an AI agent. Once linked, the chatbot can use this content while answering user questions.

This API is useful when the knowledge source is not available as a file or website URL, or when you want to directly pass text content from your application.

Endpoint

Path Parameters

Field	Type	Required	Description
`projectId`	integer	Yes	Unique identifier of the project where the chatbot belongs.

Request Body

{
  "chatbot_id": "DKDvwn...",
  "content": "Our support team is available Monday to Friday from 9 AM to 6 PM. Customers can contact us through live chat, email, or WhatsApp.",
  "file_name": "support-policy.txt",
  "is_webpage": false,
  "source_platform": "manual"
}

Request Parameters

Field	Type	Required	Description
`chatbot_id`	string	Yes	Unique chatbot identifier that should be linked with the text content.
`content`	string	Yes	Text content that should be added to the chatbot knowledge base.
`file_name`	string	No	Name used to identify the text content asset. Example: `support-policy.txt`.
`is_webpage`	boolean	No	Indicates whether the content represents webpage content. Use `false` for manually added text content.
`source_platform`	string	No	Source from where the content was added. Example values: `wordpress`.

Success Response

{
  "linkage_id": 101,
  "llm_source": "document/support-policy.txt",
  "chatbot_id": "DKDvwn...",
  "asset_id": 98765,
  "status": "active"
}

Response Fields

Field	Type	Description
`linkage_id`	integer	Unique identifier of the link created between the chatbot and the text content asset.
`llm_source`	string	LLM source or provider associated with the chatbot.
`chatbot_id`	string	Unique identifier of the chatbot linked with the content.
`asset_id`	integer	Unique identifier of the created text content asset.
`status`	string	Current status of the linked content. Example values may include `linked`, `processing`, `active`, or `failed`.

Error Responses

400 Bad Request

Returned when the request body is invalid, required fields are missing, or the text content is empty.

{
  "message": "Bad Request",
  "error": {
    "code": "BAD_REQUEST",
    "detail": "Invalid request body or missing required fields."
  }
}

401 Unauthorized

Returned when the request does not include a valid bearer token.

{
  "message": "Unauthorized",
  "error": {
    "code": "UNAUTHORIZED",
    "detail": "Authentication token is missing or invalid."
  }
}

403 Forbidden

Returned when the authenticated user does not have permission to add content to the specified chatbot.

{
  "message": "Forbidden",
  "error": {
    "code": "FORBIDDEN",
    "detail": "You do not have permission to update this chatbot."
  }
}

404 Not Found

Returned when the project or chatbot does not exist.

{
  "message": "Not Found",
  "error": {
    "code": "CHATBOT_NOT_FOUND",
    "detail": "Chatbot not found."
  }
}

500 Internal Server Error

Returned when an unexpected error occurs while adding or linking the text content.

{
  "message": "Internal Server Error",
  "error": {
    "code": "INTERNAL_SERVER_ERROR",
    "detail": "Something went wrong. Please try again later."
  }
}

Notes

Use this endpoint when you want to add plain text content directly to a chatbot’s knowledge base.

The chatbot_id and content fields are required.

The projectId in the path must belong to an existing project that the authenticated user can access.

Use file_name to give the text content a meaningful label so it can be identified later in linked assets.

Set is_webpage to false when adding manual text content.

After the content is linked, it may take some time to process and become available for chatbot responses.

You can use the List Linked Assets API to view the linked text content asset after it has been added.

curl --location 'https://agents.robofy.ai/v1/ai-agent/link_content/' \ --header 'Content-Type: application/json' \ --data '{ "chatbot_id": "string", "content": "string", "file_name": "string", "is_webpage": false, "source_platform": "string" }'

Endpoint#

Path Parameters#

Request Body#

Request Parameters#

Success Response#

Response Fields#

Error Responses#

400 Bad Request#

401 Unauthorized#

403 Forbidden#

404 Not Found#

500 Internal Server Error#

Notes#

Request

Responses