Endpoint references
SDK methods are listed by their Python names. The TypeScript SDK uses the same names in camelCase, such asdatabases.deleteCollection.
The asynchronous calls return before the work finishes. Each endpoint page explains how to confirm completion.
Typical call sequence
- Create the database:
POST /databases. - Wait for provisioning: poll
GET /databases/statusuntilinfra.ready_for_ingestionistrue. - Ingest context and wait for indexing: see the Context overview.
- Query: see the Query overview.
- Inspect usage:
GET /databases/statsreturns row counts for knowledge and memories.
Key concepts
- Database: A top-level isolated store, for example one per enterprise customer. See Databases and Collections.
- Collection: A group of context inside a database, created on the first write. See Databases and Collections.
- Metadata schema: Fields declared at database creation, or added later with Update Metadata Schema, that queries can filter on. See Metadata Filters.