Skip to contentSkip to navigationSkip to topbar
Twilio Docs

List Knowledge Chunks

(information)

Legal information

Enterprise Knowledge, including the APIs, may use artificial intelligence or machine learning technologies and is subject to the terms of the Predictive and Generative AI/ML Features Addendum(link takes you to an external page). For more details on AI usage and data, see the AI Nutrition Facts.

Enterprise Knowledge is not a HIPAA Eligible Service or PCI compliant and should not be enabled in workflows that are subject to HIPAA or PCI.

Conversations products are only available in the new Twilio Console(link takes you to an external page). If your account hasn't been migrated, you'll be redirected to the legacy Console where these products won't appear.

GET/v2/KnowledgeBases/{kbId}/Knowledge/{knowledgeId}/Chunks

Base url: https://knowledge.twilio.com (base url)

Retrieve a paginated list of all processed content chunks from a specific knowledge source. Chunks are smaller segments of content that have been extracted and processed from the original knowledge source. Each chunk contains content text and associated metadata that can be used for semantic search and retrieval operations.

Request

list-knowledge-chunks-request page anchor

Authentication

authentication page anchor

Path parameters

list-knowledge-chunks-path-parameters page anchor
Property nameTypeRequiredPIIDescription
kbIdstring
required
Not PII

A unique Knowledge Base ID using Twilio Type ID (TTID) format

Example: know_knowledgebase_00000000000000000000000000Pattern: ^know_knowledgebase_[0-7][0-9a-z]{25}$
knowledgeIdstring
required
Not PII

A unique Knowledge resource ID using Twilio Type ID (TTID) format

Example: know_knowledge_00000000000000000000000000Pattern: ^know_knowledge_[0-7][0-9a-z]{25}$

Query string

list-knowledge-chunks-query-string page anchor
Property nameTypeRequiredPIIDescription
pageSizeinteger

Optional

Not PII

How many resources to return in each list page. The default is 50, and the maximum is 1000.

Minimum: 1Maximum: 1000
pageTokenstring

Optional

Not PII

The page token. This is provided by the API.

Max length: 2048

Responses

list-knowledge-chunks-responses page anchor
200400401403404429500503

OK

SchemaExample
Property nameTypeRequiredPIIDescriptionChild properties
chunksarray[object]

Optional

Not PII
Max items: 1000
metaobject

Optional

Not PII

Pagination metadata for list operations

Example: {"key":"knowledge","pageSize":50,"nextToken":"eyJlYXN0ZXIiOiJlZ2cifQ","previousToken":""}
List Knowledge ChunksLink to code sample: List Knowledge Chunks
1
// Download the helper library from https://www.twilio.com/docs/node/install

2
const twilio = require("twilio"); // Or, for ESM: import twilio from "twilio";

3


4
// Find your Account SID and Auth Token at twilio.com/console

5
// and set the environment variables. See http://twil.io/secure

6
const accountSid = process.env.TWILIO_ACCOUNT_SID;

7
const authToken = process.env.TWILIO_AUTH_TOKEN;

8
const client = twilio(accountSid, authToken);

9


10
async function listKnowledgeChunks() {

11
  const chunks = await client.knowledge.v2

12
    .chunks(

13
      "know_knowledgebase_00000000000000000000000000",

14
      "know_knowledge_00000000000000000000000000"

15
    )

16
    .list({ limit: 20 });

17


18
  chunks.forEach((c) => console.log(c.content));

19
}

20


21
listKnowledgeChunks();

Response

Note about this response
1
{

2
  "chunks": [

3
    {

4
      "content": "content",

5
      "createdAt": "2009-07-06T20:30:00Z"

6
    }

7
  ],

8
  "meta": {

9
    "key": "key",

10
    "pageSize": 50,

11
    "nextToken": "nextToken",

12
    "previousToken": "previousToken"

13
  }

14
}