Upload Files

This page shows you how to upload files to a Catalog.

During the Alpha Release period, uploading files to your Catalog is subject to the following limitations:

  • Supported file types: .md, .txt, .pdf, .html , .ppt, .pptx, .doc, .docx, .xls, .xlsx and .csv
  • Max file size:
    • Free tier: 50MB
    • Pro tier: 150MB
  • Max file storage (per namespace):
    • Free tier: 50MB
    • Pro tier: 500MB
    • Team tier: 2GB
    • Enterprise tier: Unlimited

#Upload Files to a Catalog via API

cURL
Python

export INSTILL_API_TOKEN=********
curl -X POST 'https://api.instill.tech/v1alpha/namespaces/NAMESPACE_ID/catalogs/CATALOG_ID/files' \
--header "Authorization: Bearer $INSTILL_API_TOKEN" \
--header "Content-Type: application/json" \
--data '{
"name": "example-file.pdf",
"type": "FILE_TYPE_PDF",
"content": "base64-encoded-content"
}'

Note that the NAMESPACE_ID and CATALOG_ID path parameters must be replaced by the Catalog owner's ID (namespace) and the identifier of the Catalog to be updated, respectively.

The type field in the request body specifies the file type, given as a string. The following file types are currently supported:

  • FILE_TYPE_TEXT
  • FILE_TYPE_PDF
  • FILE_TYPE_MARKDOWN
  • FILE_TYPE_HTML
  • FILE_TYPE_DOCX
  • FILE_TYPE_DOC
  • FILE_TYPE_PPT
  • FILE_TYPE_PPTX
  • FILE_TYPE_XLSX
  • FILE_TYPE_XLS
  • FILE_TYPE_CSV

The content field in the request body contains the base64-encoded content of the file.

#Upload Files to a Catalog via 📺 Instill Console

To upload files to a Catalog from 📺 Instill Console, follow these steps:

  1. Launch 📺 Instill Console on ☁️ Instill Cloud or via a local 🔮 Instill Core deployment at http://localhost:3000.
  2. Navigate to the Artifacts page using the navigation bar.
  3. Click the Catalog card you wish to upload files to.
  4. Select Upload Documents in the left panel.
  5. Drag and drop your files into the blue box or click browse computer to upload files.

Note:

  • The upload filename must not longer than 255 characters. We recommend using a shorter filename (less than 100 characters) to avoid any issues.