Blutto Logo
Theme
Documentation

Blutto Documentation

Everything you need to get started with Blutto - from basic concepts to advanced integrations. Build better workflows, manage teams, and ship faster.

Core Concepts

Workspaces

Workspaces are the top-level containers in Blutto. They allow you to organize your projects, teams, and boards in a logical hierarchy. Each workspace can have multiple boards, team members with different permission levels, and custom settings.

Key Features:

  • • Unlimited boards per workspace
  • • Role-based access control (Admin, Member, Viewer)
  • • Custom workspace branding and settings
  • • Activity logs and audit trails

Boards & Lists

Boards use the Kanban methodology to visualize your workflow. Each board contains lists (columns) that represent different stages of your process. Tasks (cards) move through these lists as work progresses.

Board Templates:

Kanban
To Do → In Progress → Done
Scrum
Backlog → Sprint → Review → Done
Bug Tracking
Reported → Assigned → Fixed → Verified

Team Management

Collaborate effectively with your team using Blutto's comprehensive permission system. Assign tasks, track progress, and maintain clear communication across all projects.

Admin

Full workspace control, billing, and member management

Member

Create boards, manage tasks, and collaborate on projects

Viewer

Read-only access to view boards and task progress

API Examples

Create a Board

// Create a new board
const board = await blutto.boards.create({
  name: "Product Roadmap",
  description: "Q1 2025 product features",
  workspace_id: "ws_123"
})

Create a Task

// Add a task to a list
const task = await blutto.tasks.create({
  title: "Design user dashboard",
  description: "Create wireframes and mockups",
  list_id: "list_456",
  assignee_id: "user_789",
  due_date: "2025-01-15"
})

Webhook Payload

// Webhook payload example
{
  "event": "task.completed",
  "data": {
    "task_id": "task_123",
    "title": "Design user dashboard",
    "completed_by": "user_789",
    "completed_at": "2025-01-10T14:30:00Z"
  }
}