Bundles / Create
Create Bundle
Create a new bundle to organize and group related seeds together. Bundles act as folders or collections, allowing you to scope searches to specific document sets. Seeds can belong to multiple bundles simultaneously.
POST
{baseAPIUrl}/bundlesAuthentication
Required. Include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEYQuery Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| appId | string | Required | Application identifier |
| externalUserId | string | Required | External user identifier |
Request Body
| Field | Type | Required | Description |
|---|---|---|---|
| name | string | Required | Bundle name (1-100 characters) |
| color | string | Optional | Hex color code (default: #4A90E2) |
| icon | string | Optional | Icon name (e.g., folder, book) |
| description | string | Optional | Bundle description (max 500 chars) |
| metadata | object | Optional | Custom metadata object |
Response
| Field | Type | Description |
|---|---|---|
| id | string | Unique bundle identifier |
| name | string | Bundle name |
| color | string | Hex color code |
| icon | string | Icon character |
| seedCount | number | Number of seeds (0 for new) |
| createdAt | string | ISO 8601 timestamp |
Try It
Query Parameters
Application identifier for multi-tenant isolation
External user identifier for data isolation
Request Body
Bundle name (1-100 characters)
Hex color code (default: #4A90E2)
Icon name (e.g., folder, book)
Bundle description (max 500 characters)
Custom metadata object