Projects and Workspaces

Understand how Lucaro organizes your data, dashboards, and team members using workspaces and projects.

Organization Hierarchy

Lucaro uses a hierarchical structure to organize your analytics:

Workspace

Top-level container for your organization or team

Project

Groups related data sources, metrics, and dashboards

Data Sources

Metrics Registry

Dashboards

Workspaces

A workspace is the top-level container in Lucaro. It typically represents your organization or a major division within it.

Workspace Features

Member Management - Invite team members and manage their access
Billing - Subscription and usage billing is managed at the workspace level
SSO Configuration - Configure single sign-on for all workspace members
Audit Logs - Track all activity across the workspace

Creating a Workspace

curl -X POST "https://api.lucaro.dev/v2/workspaces" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Acme Corp Analytics",
    "slug": "acme-corp"
  }'

Projects

Projects group related analytics resources together. Common patterns include organizing by:

By Team

Marketing Analytics
Sales Performance
Product Metrics
Finance Reports

By Data Domain

Customer Analytics
Revenue Metrics
Operational Data
Web Analytics

Project Contents

Each project contains:

Resource	Description
Data Sources	Connections to databases and warehouses
Metrics Registry	Centralized metric definitions
Dashboards	Interactive visualizations and reports
Alerts	Threshold and anomaly alerts
Subscriptions	Scheduled email reports

Creating a Project

curl -X POST "https://api.lucaro.dev/v2/projects" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "workspace_id": "ws_abc123",
    "name": "Marketing Analytics",
    "description": "Campaign performance and attribution metrics"
  }'

Access Control

Permissions are managed at both the workspace and project level:

Role	Workspace	Project
Owner	Full admin access	Full access to all projects
Admin	Manage members and settings	Create and manage projects
Editor	View workspace	Edit dashboards and metrics
Viewer	View workspace	View dashboards only