Knowledge

List Knowledge Sources

Changed on

Retrieve a paginated list of all knowledge sources for a specific knowledge base. Knowledge sources represent unstructured data sources such as documents, websites, or text content that can be used for context and information retrieval.

get/v2/KnowledgeBases/{kbId}/Knowledge

Request

  • Base URL
    https://knowledge.twilio.com
  • URL
    https://knowledge.twilio.com/v2/KnowledgeBases/{kbId}/Knowledge
  • Auth
    HTTP basic

Query parameters

pageinteger

The page index. This value is simply for client state.

pageSizeinteger

The maximum number of items to return per page, maximum of 1000.

pageTokenstring

The token for the page of results to retrieve.

Response

OK

Example response

{
  "knowledge": [
    {
      "id": "know_knowledge_00000000000000000000000000",
      "name": "Company FAQ Knowledge Base",
      "description": "Frequently asked questions and answers for customer support",
      "status": "COMPLETED",
      "source": {
        "type": "Web",
        "url": "https://example.com/faq",
        "crawlDepth": 2,
        "crawlPeriod": "NEVER"
      },
      "createdAt": "2026-01-15T10:30:00Z",
      "updatedAt": "2026-01-15T11:45:00Z"
    }
  ],
  "meta": {
    "pageSize": 50,
    "nextToken": "eyJlYXN0ZXIiOiJlZ2cifQ",
    "previousToken": "eyJlYXN0ZXIiOiJlZ2cifQ"
  }
}

Changes

    • info

      added the optional property /////// to the response with the status

    • breaking

      the response property's max was increased from 99999.00 to 999999.00 for the response status

    • breaking

      the response property's max was increased from 99999.00 to 999999.00 for the response status

    • breaking

      the response property's max was increased from 99999.00 to 999999.00 for the response status

    • breaking

      the response property's max was increased from 99999.00 to 999999.00 for the response status

    • breaking

      the response property's max was increased from 99999.00 to 999999.00 for the response status

    • info

      for the query request parameter pageToken, the maxLength was increased from 500 to 4096

    • info

      the response's property default value 50 was removed for the status

    • info

      removed the text/mdx enum value from the /////// response property for the response status