> ## Documentation Index > Fetch the complete documentation index at: https://docs.voiceflow.com/llms.txt > Use this file to discover all available pages before exploring further. # Upload table document > Upload a structured document to the knowledge base. ## OpenAPI ````yaml /specs/realtime/openapi.public.json post /v1alpha1/public/knowledge-base/document/upload/table openapi: 3.0.0 info: title: Realtime description: Realtime gateway API service version: 1.0.0 contact: {} servers: - url: https://realtime-api.voiceflow.com security: [] paths: /v1alpha1/public/knowledge-base/document/upload/table: post: tags: - KBPublicApiDocument - Public-Docs summary: Upload table document description: Upload a structured document to the knowledge base. operationId: KnowledgeBaseDocumentApiPublicHTTPController_uploadTable parameters: - name: overwrite required: false in: query schema: description: >- If set to true, the existing table with the same name will be overwritten. anyOf: - type: boolean - type: string enum: - 'true' - 'false' x-enumNames: - 'TRUE' - 'FALSE' - name: markdownConversion required: false in: query schema: description: >- When enabled, HTML is automatically converted to markdown to generate better chunks. anyOf: - type: boolean - type: string enum: - 'true' - 'false' x-enumNames: - 'TRUE' - 'FALSE' - name: llmBasedChunks required: false in: query schema: anyOf: - type: boolean - type: string enum: - 'true' - 'false' x-enumNames: - 'TRUE' - 'FALSE' - name: llmGeneratedQ required: false in: query schema: description: >- When enabled, an LLM will be used to generate a question based on the document context and specific chunk, then prepend it to the chunk. This enhances retrieval by aligning chunks with potential user queries. anyOf: - type: boolean - type: string enum: - 'true' - 'false' x-enumNames: - 'TRUE' - 'FALSE' - name: llmContentSummarization required: false in: query schema: description: >- When enabled, an LLM summarizes and rewrites the content, removing unnecessary information and focusing on important parts to optimize for retrieval. Limited to 15 rows per table upload. anyOf: - type: boolean - type: string enum: - 'true' - 'false' x-enumNames: - 'TRUE' - 'FALSE' - name: llmPrependContext required: false in: query schema: description: >- When enabled, an LLM generates a context summary based on the document and chunk context, and prepends it to each chunk. This improves retrieval by providing additional context to each chunk. Note: If both llmGeneratedQ and llmPrependContext are set to true, llmGeneratedQ takes precedence, and the context summarization will not be applied. anyOf: - type: boolean - type: string enum: - 'true' - 'false' x-enumNames: - 'TRUE' - 'FALSE' requestBody: required: true content: application/json: schema: type: object properties: data: type: object properties: name: type: string description: A unique name identifying the table. schema: type: object properties: searchableFields: type: array items: type: string metadataFields: type: array items: type: string required: - searchableFields items: type: array items: type: object additionalProperties: {} description: >- An array of items to be included in the table. Each item can have completely custom fields of various types including string, number, array, or object. folderID: type: string url: type: string description: The source URL of the document. documentMetadata: description: >- An array of document metadata fields. > **💡 Tip:** This metadata can be used in agent KB metadata filter conditions. [Learn more about metadata filtering](/documentation/build/querying-the-knowledge-base#meta-data-filtering). type: array items: type: object properties: key: type: string maxLength: 255 values: type: array items: type: string required: - key - values projectEnvironmentIDOrAlias: description: >- The alias of the environment to target (ie. `main`). You can find this in the environments page of your agent. > **💡 Tip:** [Learn more about Environments](/documentation/deploy/environments). type: string required: - name - items required: - data responses: '200': description: The document was uploaded successfully. content: application/json: schema: $ref: '#/components/schemas/DocumentFindOnePublicResponse' security: - auth: [] components: schemas: DocumentFindOnePublicResponse: type: object properties: chunks: type: array items: $ref: '#/components/schemas/KBDocumentChunk' data: nullable: true type: object properties: documentID: type: string data: nullable: true allOf: - $ref: '#/components/schemas/KBDocumentData' updatedAt: type: string format: date-time pattern: >- ^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d(?::[0-5]\d(?:\.\d+)?)?(?:Z))$ status: $ref: '#/components/schemas/KBDocumentStatus' required: - documentID - data - updatedAt - status metadata: type: array items: $ref: '#/components/schemas/DocumentMetadataFields' required: - data KBDocumentChunk: type: object properties: chunkID: type: string content: type: string metadata: type: object additionalProperties: {} required: - chunkID - content KBDocumentData: oneOf: - $ref: '#/components/schemas/KBDocumentUrlData' - $ref: '#/components/schemas/KBDocumentDocxData' - $ref: '#/components/schemas/KBDocumentPDFData' - $ref: '#/components/schemas/KBDocumentTextData' - $ref: '#/components/schemas/KBDocumentMarkdownData' - $ref: '#/components/schemas/KBDocumentCSVData' - $ref: '#/components/schemas/KBDocumentXLSXData' - $ref: '#/components/schemas/KBDocumentTableData' KBDocumentStatus: type: object properties: type: $ref: '#/components/schemas/KnowledgeBaseDocumentStatus' data: {} required: - type DocumentMetadataFields: type: object properties: key: type: string values: type: array items: type: string required: - key - values KBDocumentUrlData: type: object properties: type: type: string enum: - url x-enumNames: - URL name: type: string url: type: string refreshRate: allOf: - $ref: '#/components/schemas/KnowledgeBaseDocumentRefreshRate' lastSuccessUpdate: type: string accessTokenID: type: number integrationExternalID: type: string source: allOf: - $ref: '#/components/schemas/KnowledgeBaseDocumentIntegrationType' required: - type - name - url KBDocumentDocxData: type: object properties: type: type: string enum: - docx x-enumNames: - DOCX name: type: string url: nullable: true type: string required: - type - name KBDocumentPDFData: type: object properties: type: type: string enum: - pdf x-enumNames: - PDF name: type: string url: nullable: true type: string required: - type - name KBDocumentTextData: type: object properties: type: type: string enum: - text x-enumNames: - TEXT name: type: string canEdit: type: boolean url: nullable: true type: string required: - type - name KBDocumentMarkdownData: type: object properties: type: type: string enum: - md x-enumNames: - MD name: type: string url: nullable: true type: string required: - type - name KBDocumentCSVData: type: object properties: type: type: string enum: - csv x-enumNames: - CSV name: type: string rowsCount: type: number url: nullable: true type: string required: - type - name KBDocumentXLSXData: type: object properties: type: type: string enum: - xlsx x-enumNames: - XLSX name: type: string rowsCount: type: number url: nullable: true type: string required: - type - name KBDocumentTableData: type: object properties: type: type: string enum: - table x-enumNames: - TABLE name: type: string rowsCount: type: number url: nullable: true type: string required: - type - name - rowsCount KnowledgeBaseDocumentStatus: type: string enum: - ERROR - PENDING - SUCCESS - INITIALIZED x-enumNames: - ERROR - PENDING - SUCCESS - INITIALIZED KnowledgeBaseDocumentRefreshRate: type: string enum: - daily - weekly - monthly - never x-enumNames: - DAILY - WEEKLY - MONTHLY - NEVER KnowledgeBaseDocumentIntegrationType: type: string enum: - zendesk - shopify x-enumNames: - ZENDESK - SHOPIFY securitySchemes: auth: type: apiKey in: header name: authorization description: Voiceflow API key ````