Seed Organisms (v1)
Method & Path
POST /api/v1/workspace/:workspaceId/labs/organisms/seed
Actual backend path: /v1/workspace/:workspaceId/labs/organisms/seed
Description
Seed organisms from external sources. This endpoint replaces existing organisms and adds missing ones from the seed data.
Authentication
Required: JWT token in Authorization header
Required Permissions:
labs.manage
Headers
| Header | Type | Required | Description |
|---|---|---|---|
Authorization | string | Yes | Bearer token: Bearer <token> |
Path Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
workspaceId | string | Yes | Workspace identifier (MongoDB ObjectId) |
Response 200 OK
{
"success": true,
"count": 50,
"message": "Successfully seeded 50 organisms"
}
| Field | Type | Description |
|---|---|---|
success | boolean | Indicates if the operation was successful |
count | number | Number of organisms seeded |
message | string | Success message |
Common Errors
401 Unauthorized: Missing or invalid authentication token
403 Forbidden: Insufficient permissions (labs.manage required) or subscription expired
404 Not Found: Workspace not found
422 Validation Error: Invalid workspace ID format
500 Internal Server Error: Error during seeding process