List Collections
Retrieve collections with pagination and filtering options. Collections are used to organize and store knowledge bases, documents, and other content.
Bearer token for authentication
API key for authentication (alternative to Authorization header)
Optional. Derived from API Key, but can be specified if you have access to multiple workspaces
Query Parameters
Number of collections to skip for pagination (minimum: 0)
Maximum number of collections to return (1-1000)
Filter by collection status (active, archived)
Filter by visibility (public, private)
Search collections by name or description
Filter by tags (comma-separated)
Response
Array of collection objects
Unique collection identifier
Storage type (pgvector, chroma, pinecone, etc.)
Collection visibility (private, public)
Collection status (active, archived)
User who created the collection
Total number of collections matching the filters
curl -X GET "https://api.mielto.com/api/v1/collections?skip=0&limit=50&status=active" \
-H "X-API-Key: YOUR_API_KEY"
{
"data": [
{
"id": "col_123456789",
"name": "Product Documentation",
"description": "All product documentation and guides",
"store_type": "pgvector",
"visibility": "private",
"status": "active",
"tags": ["docs", "product"],
"stats": {
"document_count": 42,
"total_size_mb": 15.7,
"last_updated": "2024-01-16T09:30:00Z"
},
"meta_data": {
"category": "documentation"
},
"embedding": {
"provider": "openai",
"model": "text-embedding-ada-002",
"dimensions": 1536
},
"workspace_id": "wsp_123456789",
"created_by": "usr_123456789",
"created_at": "2024-01-15T10:00:00Z",
"updated_at": "2024-01-16T09:30:00Z"
}
],
"total_count": 1
}
