Upload Files | Documentation

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

The Catalog supports the following file types: .md, .txt, .pdf, .html , .ppt, .pptx, .doc, .docx, .xls, .xlsx and .csv.

#Upload Files to a Catalog via API

cURL

Python

export INSTILL_API_TOKEN=********
curl -X POST 'HOST_URL/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.

INFO

If you are using Instill Core as a managed service, set HOST_URL to https://private.instill-ai.com. If you are self-hosting Instill Core, use http://localhost:8080.

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 Console

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

Launch Console via a local Instill Core deployment at http://localhost:3000, or by selecting the Go to console button in the bottom-left of the Instill Agent interface if you are using Instill Core as a managed service.
Navigate to the Artifacts page using the navigation bar.
Click the Catalog card you wish to upload files to.
Select Upload Documents in the left panel.
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.