Skip to main content

Upload Entity Catalog

The Entities Service provides entity and collection management for data uploads and embedding job triggering.

Syncing entity catalog​

You must provide PRIMARY_KEY (the unique identifier for entities. For example, product-id in retail) and MODEL_KEY (model name to embed candidates. Look at models-list for available models).

From Files​

curl -X POST "https://api.trydodo.xyz/api/entities/ingest?&primary_key=${PRIMARY_KEY}&model_key=${MODEL_KEY}&source=files" \
  -H "Authorization: Bearer ${API_KEY}" \
  -F "files=@product_catalog.csv;type=text/csv"

Streaming from Database​

curl -X POST "https://api.trydodo.xyz/api/entities/ingest?primary_key=${PRIMARY_KEY}&model_key=${MODEL_KEY}&source=database" \
  -H "Authorization: Bearer ${API_KEY}" \
  -F "db_type=mongodb" \
  -F "connection_string=your-mongodb-connection-string" \
  -F "database_name=your-database" \
  -F "collection_name=products" \
  -F "filters={}"

Supported File Formats​

  • CSV
  • Parquet

Deployment​

The Entities service is deployed and accessible at: https://api.trydodo.xyz/api/entities