Create Catalog

This page shows you how to create a new, empty Instill Catalog.

This is the first step that is required before you are able to upload and process your files with 💾 Instill Artifact into a unified AI-ready format.

#Create Catalog via API

cURL

Python

export INSTILL_API_TOKEN=********
curl -X POST 'https://api.instill.tech/v1alpha/namespaces/{namespaceId}/catalogs' \
--header "Content-Type: application/json" \
--header "Authorization: Bearer $INSTILL_API_TOKEN" \
--data '{
  "name": "Your Catalog Name",
  "description": "A brief description of your Catalog"
}'

Note that the {namespaceId} path parameter must be replaced by the Catalog owner's ID (namespace). The new name should be lowercase, without any space or special character except for hyphens. It cannot start with a number or hyphen, and should be less than 32 characters.

#Create Catalog via 📺 Instill Console

To create a new Catalog from 📺 Instill Console, follow these steps:

Launch 📺 Instill Console on ☁️ Instill Cloud or via a local 🔮 Instill Core deployment at http://localhost:3000.
Navigate to the Artifacts page using the navigation bar.
Click the + Create Catalog button.
Select the Owner (namespace).
Enter the name for your Catalog.
Enter the description for your Catalog.
Click the Create button.