Get Projects
GET /api/projects
Get all projects with comprehensive intelligence metrics.
Retrieves complete list of projects from ChromaDB with full intelligence data including AI learning patterns, knowledge base metrics, analytics, and agent assignments. Supports optional filtering by status and project type.
This endpoint provides the primary project listing for dashboard and project selection interfaces, including real-time analytics data from ProjectManager.
Args: status: Optional status filter (e.g., “active”, “archived”, “completed”) project_type: Optional project type filter (e.g., “fiction”, “general”, “custom”)
Returns: ProjectsResponse: Complete project list with intelligence metrics and summary statistics - projects: List of ProjectItem with full details - summary: Aggregate metrics across all projects - last_update: Timestamp of response generation
Raises: HTTPException: 500 if project retrieval fails
Example Response:
json { "projects": [ { "id": "proj_abc123", "name": "My Novel", "type": "fiction", "status": "active", "intelligence": { "assignedAgents": ["HAWKEN", "LAGAN"], "knowledgeBase": {"documents": 127, "connections": 453} }, "analytics": { "timeSpent": 2450.5, "activeDays": 37, "productivityScore": 82.3 } } ], "summary": { "totalProjects": 15, "activeProjects": 12, "totalAgentAssignments": 45 }, "lastUpdate": "2025-01-31T15:45:00Z" }
Parameters
Section titled “ Parameters ”Query Parameters
Section titled “Query Parameters ”Responses
Section titled “ Responses ”Successful Response
Projects endpoint response with intelligence metrics.
Main API response for GET /projects endpoint providing list of all projects with intelligence data, analytics, and summary metrics for dashboard display.
Fields:
projects: List of project items with full details (list[ProjectItem])summary: Aggregate summary metrics (ProjectSummaryMetrics object)last_update: Last update timestamp ISO 8601 (string)
JSON Example:
{
"projects": [
{
"id": "proj_abc123",
"name": "My Novel",
...
}
],
"summary": {
"totalProjects": 15,
"activeProjects": 12,
...
},
"lastUpdate": "2025-01-31T15:45:00Z"
}object
List of projects
Complete project details with intelligence and analytics.
Comprehensive project data structure including basic metadata, settings, intelligence data, and analytics metrics. Represents a complete project entity for API responses.
Fields:
id: Unique project identifier (string)name: Project name (string)description: Project description (string)type: Project type (string, e.g., “fiction”, “general”)status: Project status (string, e.g., “active”, “archived”)created_at: Creation timestamp ISO 8601 (string)modified_at: Last modification timestamp ISO 8601 (string)owner: Project owner user ID (string)collaborators: List of collaborator user IDs (list[str])settings: Project configuration settings (ProjectSettings object)intelligence: Project intelligence data (ProjectIntelligence object)analytics: Project analytics metrics (ProjectAnalytics object)
JSON Example:
{
"id": "proj_abc123",
"name": "My Novel",
"description": "Main writing project",
"type": "fiction",
"status": "active",
"createdAt": "2025-01-15T10:00:00Z",
"modifiedAt": "2025-01-31T15:30:00Z",
"owner": "user_001",
"collaborators": ["user_002", "user_003"],
"settings": { ... },
"intelligence": { ... },
"analytics": { ... }
}object
Unique project identifier
Project name
Project description
Project type
Project status
Creation timestamp (ISO 8601)
Last modification timestamp (ISO 8601)
Project owner user ID
Collaborator user IDs
Project settings
object
Project visibility level
Enable automatic saving
Enable context preservation
Enable AI assistance
Enable notifications
Integration settings
object
Enable MIME integration
Enable research hub integration
Enable analytics integration
Per-project Lorekeeper configuration.
Defines project-specific rules for lore consistency validation including prohibited elements, naming conventions, and cultural context. Read by the lore validator at analysis time via ProjectConfig.lore_rules.
Fields:
prohibited_elements: Elements that should not appear in this project’s writingnaming_patterns: Descriptions of naming conventions (e.g. “Yoruba-inspired”)cultural_context: Description of the project’s cultural/thematic settingstrict_naming: Whether to enforce naming convention checks
object
Prohibited story elements
Naming convention descriptions
Cultural/thematic setting
Enforce naming conventions
Per-project publishing readiness weight configuration.
All fields are optional. Absent fields fall back to the system defaults. Weights are normalised to sum to 1.0 at calculation time.
Per-project document save directory. Empty = use global default.
Divine agents assigned to this project
Per-project AI personality/tone prompt
Lore category names scoping per-project lore search
Genre overlay drivers for the Authored Library (M9). Empty list means universal voicing only. Values must be one of the 12 SUPPORTED_GENRES the authored-library layer recognises.
Per-project LLM tuning knobs stored inside ProjectSettings.
Declared as a typed Pydantic sub-model (rather than a raw dict) so
IshvanaBaseModel’s alias generator emits camelCase over the wire —
without that, the frontend sees max_tokens / search_results_count
while its mapper expects maxTokens / searchResultsCount.
Per-agent base system prompt overrides keyed by lowercase agent id (e.g. ‘lagan’). Empty dict / missing key means the agent uses its hardcoded default identity text.
object
Project intelligence
object
Assigned divine agents
Project context data
object
AI learning patterns
object
User behavior patterns
object
Content preferences
object
Workflow optimization patterns
object
Knowledge base metrics
object
Number of documents
Number of connections
AI-generated insights
Project analytics
object
Total time spent in minutes
Number of active days
Completion percentage
Collaborator activity scores
object
Agent interactions count
Productivity score
Analytics trends
object
Daily trend data
Weekly trend data
Monthly trend data
Whether TTRPG mechanics system is enabled
Summary metrics
object
Total projects count
Active projects count
Completed projects count
Total collaborators count
Total agent assignments
Average completion rate
Average productivity score
Last update timestamp (ISO 8601)
Validation Error