WhatsAble
API v1AI bots

List a bot's knowledge documents

gethttps://api.whatsable.app/v1/ai-bots/{id}/knowledge-files
Build a request to copy

This page never sends a request. Fill in the fields, then copy the request and run it from your server.

Request
curl -X GET 'https://api.whatsable.app/v1/ai-bots/string/knowledge-files'

Authorization

bearerAuth
headerAuthorizationBearer <nfy_live_<32 characters>>

An API key from Settings > API keys, sent as Authorization: Bearer <key>.

Path Parameters

id*string

The bot id.

Length1 <= length <= 64

Query Parameters

limit?integer

How many items to return, 1 to 100.

Range1 <= value <= 100
Default25
cursor?string

The next_cursor of the previous page. An expired or malformed cursor answers 400 invalid_cursor.

Length1 <= length <= 512

Response Body

A page of knowledge documents, newest first.

application/json
  1. response
object*string
data*array<>
has_more*boolean

True when another page follows this one.

next_cursor*|

Pass as cursor to read the next page. Null on the last page. Valid for 24 hours.

Example Request
curl -X GET 'https://api.whatsable.app/v1/ai-bots/string/knowledge-files'
Example Response
{  "object": "list",  "data": [    {      "object": "knowledge_file",      "id": "cm2v8f1a00001qz8h7k8l9m0n",      "bot_id": "cm2v8b1a00001qz8h3j4k5l6m",      "filename": "price-list.pdf",      "mime_type": "application/pdf",      "size_bytes": 182340,      "status": "ready",      "failure_reason": null,      "extracted_length": 12873,      "created_at": "2026-10-20T19:51:21Z"    }  ],  "has_more": true,  "next_cursor": "string"}