Create Bundle
Create a new bundle to organize seeds into collections with custom metadata.
Authentication
Required. Include your API key in the Authorization header:
Authorization: Bearer YOUR_API_KEY
Query Parameters
| Parameter | Type | Required | Description |
|---|
| appId | string | Yes | Application identifier for multi-tenant isolation |
| externalUserId | string | Yes | External user identifier for data isolation |
Request Body
| Field | Type | Required | Description |
|---|
| name | string | Yes | Bundle name (1-100 characters) |
| color | string | No | Hex color code (default: #4A90E2) |
| icon | string | No | Icon name (e.g., folder, book) |
| description | string | No | Bundle description (max 500 characters) |
| metadata | object | No | Custom metadata object |
Response Fields
| 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 in bundle (0 for new bundles) |
| createdAt | string | ISO 8601 timestamp |
Status Codes
| Code | Description |
|---|
| 201 | Created - Bundle created successfully |
| 400 | Bad Request - Invalid parameters or missing required fields |
| 401 | Unauthorized - Invalid API key |
| 500 | Internal Server Error |
Base URL: All requests use https://api-development.myneutron.ai which adapts to your environment.