User Management

Invite team members, manage roles, and control access to your Lucaro workspaces and projects.

Inviting Users

Navigate to Workspace Settings → Members
Click Invite Members
Enter email addresses (comma-separated for multiple)
Select a role for the new members
Click Send Invitations

Invited users will receive an email with a link to join your workspace. Pending invitations can be viewed and resent from the Members page.

User Roles

Role	Description
Owner	Full access including billing and workspace deletion. Only one owner per workspace.
Admin	Manage members, projects, integrations, and settings. Cannot access billing.
Editor	Create and edit dashboards, metrics, and alerts. Cannot manage members.
Viewer	View dashboards and reports. Cannot create or edit content.

Managing Members

Change a User's Role

Go to Workspace Settings → Members
Find the user in the list
Click the role dropdown next to their name
Select the new role

Remove a User

Go to Workspace Settings → Members
Find the user in the list
Click the ... menu and select Remove
Confirm the removal

Project-Level Access

You can restrict access to specific projects within a workspace:

All Projects - User has access to every project (default for Admins)
Specific Projects - User only sees selected projects

curl -X PATCH "https://api.lucaro.dev/v2/workspace-members/{memberId}" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "role": "editor",
    "project_access": {
      "type": "specific",
      "project_ids": ["proj_abc123", "proj_def456"]
    }
  }'

API Keys

Users can create personal API keys for programmatic access:

Go to Account Settings → API Keys
Click Create API Key
Give the key a descriptive name
Set an expiration date (optional)
Copy and securely store the key

Security Note: API keys inherit the user's permissions. Treat them like passwords and never share them.