Treasure Data

Treasure Data Text Knowledge Base API

The TextKnowledgeBase API from Treasure Data — 2 operation(s) for textknowledgebase.

GitHub OpenAPI

Operations 4

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /api/text_knowledge_bases Create a text knowledge base · create #
Ask an LLM
“Can I build a knowledge base from plain text for an AI agent?”
“What is needed to create a text knowledge base?”
Tell an agent
Create a text knowledge base with {data}.
Set up a new text-based knowledge base using {data}.
DELETE /api/text_knowledge_bases/{id} Delete a text knowledge base · destroy #
Ask an LLM
“How do I remove a text knowledge base?”
“Is deleting a text knowledge base permanent?”
Tell an agent destructive · confirm first
Delete text knowledge base {id}.
Remove the outdated text knowledge base {id}.
GET /api/text_knowledge_bases/{id} Get a text knowledge base · show #
Ask an LLM
“What is in a particular text knowledge base?”
“Can I fetch one text knowledge base by ID?”
Tell an agent
Show text knowledge base {id}.
Fetch the contents and settings of text knowledge base {id}.
PATCH /api/text_knowledge_bases/{id} Update a text knowledge base · update #
Ask an LLM
“Can I change the text in an existing text knowledge base?”
“What can I edit on a text knowledge base?”
Tell an agent
Update text knowledge base {id} with {data}.
Edit the existing text knowledge base {id}.

Documentation

📖
Documentation
https://docs.treasure.ai/apis/td-api
📖
APIReference
https://docs.treasure.ai/apis/td_api_v3-public
📖
GettingStarted
https://docs.treasure.ai/apis/td-api
📖
Documentation
https://docs.treasure.ai/apis/audience-api/overview
📖
APIReference
https://docs.treasure.ai/apis/td_cdp_api-public
📖
GettingStarted
https://docs.treasure.ai/apis/audience-api
📖
Documentation
https://docs.treasure.ai/apis/llm-api
📖
APIReference
https://docs.treasure.ai/apis/llm_api-public
📖
GettingStarted
https://docs.treasure.ai/apis/llm-api
📖
APIReference
https://docs.treasure.ai/apis/dwh_integration_api-public
📖
GettingStarted
https://docs.treasure.ai/apis/dwh-integration-api/quickstart
📖
GettingStarted
https://docs.treasure.ai/apis/p13n-api
📖
GettingStarted
https://docs.treasure.ai/apis/postback-v2/quickstart

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/treasure-data/refs/heads/main/openapi/treasure-data-textknowledgebase-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/treasure-data:treasure-data-textknowledgebase-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

treasure-data-textknowledgebase-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: llm-api Text Knowledge Base API
  version: 1.0.0
servers:
- url: https://llm-api.treasuredata.com
- url: https://llm-api.eu01.treasuredata.com
- url: https://llm-api.ap02.treasuredata.com
- url: https://llm-api.treasuredata.co.jp
security:
- ApiKeyAuth: []
tags:
- name: TextKnowledgeBase
paths:
  /api/text_knowledge_bases:
    post:
      summary: create
      tags:
      - TextKnowledgeBase
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                data:
                  type: object
                  properties:
                    type:
                      type: string
                    attributes:
                      type: object
                      properties:
                        name:
                          type: string
                        text:
                          type: string
                        projectId:
                          type: string
                      required:
                      - name
                      - text
                      - projectId
                  required:
                  - type
                  - attributes
              required:
              - data
            example:
              data:
                type: textKnowledgeBases
                attributes:
                  name: Text Knowledge Base
                  text: This is a sample text for the knowledge base.
                  projectId: 00000000-0000-0000-0000-000000000001
      responses:
        '201':
          description: creates a new TextKnowledgeBase
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      type:
                        type: string
                      links:
                        type: object
                        properties:
                          self:
                            type: string
                        required:
                        - self
                      attributes:
                        type: object
                        properties:
                          createdAt:
                            type: string
                          updatedAt:
                            type: string
                          projectId:
                            type: string
                          name:
                            type: string
                          text:
                            type: string
                          isManaged:
                            type: boolean
                        required:
                        - createdAt
                        - updatedAt
                        - projectId
                        - name
                        - text
                        - isManaged
                    required:
                    - id
                    - type
                    - links
                    - attributes
                required:
                - data
              example:
                data:
                  id: 00000000-0000-0000-0000-000000000001
                  type: textKnowledgeBases
                  links:
                    self: http://www.example.com/api/text_knowledge_bases/00000000-0000-0000-0000-000000000001
                  attributes:
                    createdAt: '2025-05-01T05:05:14.000Z'
                    updatedAt: '2025-05-01T05:05:14.000Z'
                    projectId: 00000000-0000-0000-0000-000000000001
                    name: Text Knowledge Base
                    text: This is a sample text for the knowledge base.
                    isManaged: false
        '422':
          description: returns errors for invalid parameters
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        title:
                          type: string
                        detail:
                          type: string
                        code:
                          type: string
                        source:
                          type: object
                          properties:
                            pointer:
                              type: string
                          required:
                          - pointer
                        status:
                          type: string
                        meta:
                          type: object
                          properties:
                            validationCode:
                              type: string
                          required:
                          - validationCode
                      required:
                      - title
                      - detail
                      - code
                      - source
                      - status
                      - meta
                required:
                - errors
              example:
                errors:
                - title: can't be blank
                  detail: text - can't be blank
                  code: '100'
                  source:
                    pointer: /data/attributes/text
                  status: '422'
                  meta:
                    validationCode: CANNOT_BE_BLANK
      operationId: postApiTextKnowledgeBases
      x-operation-id-source: derived
  /api/text_knowledge_bases/{id}:
    delete:
      summary: destroy
      tags:
      - TextKnowledgeBase
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        example: 00000000-0000-0000-0000-000000000001
      responses:
        '204':
          description: deletes the TextKnowledgeBase
      operationId: deleteApiTextKnowledgeBasesById
      x-operation-id-source: derived
    get:
      summary: show
      tags:
      - TextKnowledgeBase
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        example: 00000000-0000-0000-0000-000000000001
      responses:
        '200':
          description: returns the details of a specific TextKnowledgeBase
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      type:
                        type: string
                      links:
                        type: object
                        properties:
                          self:
                            type: string
                        required:
                        - self
                      attributes:
                        type: object
                        properties:
                          createdAt:
                            type: string
                          updatedAt:
                            type: string
                          projectId:
                            type: string
                          name:
                            type: string
                          text:
                            type: string
                          isManaged:
                            type: boolean
                        required:
                        - createdAt
                        - updatedAt
                        - projectId
                        - name
                        - text
                        - isManaged
                    required:
                    - id
                    - type
                    - links
                    - attributes
                required:
                - data
              example:
                data:
                  id: 00000000-0000-0000-0000-000000000001
                  type: textKnowledgeBases
                  links:
                    self: http://www.example.com/api/text_knowledge_bases/00000000-0000-0000-0000-000000000001
                  attributes:
                    createdAt: '2025-05-01T05:05:14.000Z'
                    updatedAt: '2025-05-01T05:05:14.000Z'
                    projectId: 00000000-0000-0000-0000-000000000001
                    name: Sample Knowledge Base
                    text: This is a sample text for the TextKnowledgeBase.
                    isManaged: false
      operationId: getApiTextKnowledgeBasesById
      x-operation-id-source: derived
    patch:
      summary: update
      tags:
      - TextKnowledgeBase
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
        example: 00000000-0000-0000-0000-000000000001
      requestBody:
        content:
          application/json:
            schema:
              type: object
              properties:
                data:
                  type: object
                  properties:
                    type:
                      type: string
                    id:
                      type: string
                    attributes:
                      type: object
                      properties:
                        name:
                          type: string
                        text:
                          type: string
                      required:
                      - name
                      - text
                  required:
                  - type
                  - id
                  - attributes
              required:
              - data
            example:
              data:
                type: textKnowledgeBases
                id: 00000000-0000-0000-0000-000000000001
                attributes:
                  name: Updated Name
                  text: Updated text
      responses:
        '200':
          description: updates the TextKnowledgeBase successfully
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                      type:
                        type: string
                      links:
                        type: object
                        properties:
                          self:
                            type: string
                        required:
                        - self
                      attributes:
                        type: object
                        properties:
                          createdAt:
                            type: string
                          updatedAt:
                            type: string
                          projectId:
                            type: string
                          name:
                            type: string
                          text:
                            type: string
                          isManaged:
                            type: boolean
                        required:
                        - createdAt
                        - updatedAt
                        - projectId
                        - name
                        - text
                        - isManaged
                    required:
                    - id
                    - type
                    - links
                    - attributes
                required:
                - data
              example:
                data:
                  id: 00000000-0000-0000-0000-000000000001
                  type: textKnowledgeBases
                  links:
                    self: http://www.example.com/api/text_knowledge_bases/00000000-0000-0000-0000-000000000001
                  attributes:
                    createdAt: '2025-05-01T05:05:14.000Z'
                    updatedAt: '2025-05-01T05:05:14.000Z'
                    projectId: 00000000-0000-0000-0000-000000000001
                    name: Updated Name
                    text: Updated text
                    isManaged: false
        '422':
          description: returns detailed errors for invalid updates
          content:
            application/vnd.api+json:
              schema:
                type: object
                properties:
                  errors:
                    type: array
                    items:
                      type: object
                      properties:
                        title:
                          type: string
                        detail:
                          type: string
                        code:
                          type: string
                        source:
                          type: object
                          properties:
                            pointer:
                              type: string
                          required:
                          - pointer
                        status:
                          type: string
                        meta:
                          type: object
                          properties:
                            validationCode:
                              type: string
                          required:
                          - validationCode
                      required:
                      - title
                      - detail
                      - code
                      - source
                      - status
                      - meta
                required:
                - errors
              example:
                errors:
                - title: can't be blank
                  detail: name - can't be blank
                  code: '100'
                  source:
                    pointer: /data/attributes/name
                  status: '422'
                  meta:
                    validationCode: CANNOT_BE_BLANK
                - title: can't be blank
                  detail: toolTarget/name - can't be blank
                  code: '100'
                  source:
                    pointer: /data/attributes/toolTarget/name
                  status: '422'
                  meta:
                    validationCode: CANNOT_BE_BLANK
                - title: can't be blank
                  detail: text - can't be blank
                  code: '100'
                  source:
                    pointer: /data/attributes/text
                  status: '422'
                  meta:
                    validationCode: CANNOT_BE_BLANK
      operationId: patchApiTextKnowledgeBasesById
      x-operation-id-source: derived
components:
  securitySchemes:
    ApiKeyAuth:
      type: http
      scheme: TD1