Skip to content
Control Center

Create and manage tickets

This guide shows you how to create and manage tickets.

Create a ticket

Section titled “Create a ticket”

Via the UI

Section titled “Via the UI”
  1. Navigate to Tickets in the sidebar
  2. Click Create ticket
  3. Fill in:
    • Title: short summary
    • Description: detailed description in Markdown
    • Priority: low, medium, high, critical
    • Project: optional project grouping
    • Provider: local (default) or Linear
  4. Click Create

The ticket is created in the open status.

Via MCP tool

Section titled “Via MCP tool”
create_ticket(
  workspace_id: "...",
  title: "Fix login timeout on slow connections",
  description: "...",
  priority: "high"
)

Via agent

Section titled “Via agent”

Ask an agent in a channel:

Create a ticket for fixing the login timeout issue on slow connections.

The agent uses the create_ticket MCP tool.

Update ticket status

Section titled “Update ticket status”

Tickets follow this lifecycle:

open → in_progress → done
                   → failed
                   → cancelled
      → blocked → in_progress

To update:

  1. Open the ticket
  2. Click the status dropdown
  3. Select the new status
  4. The TicketWorkflowService validates the transition

Status changes emit domain events (e.g. TicketStarted, TicketCompleted) that can trigger pipelines.

Assign a ticket

Section titled “Assign a ticket”
  1. Open the ticket
  2. Click Assign
  3. Select an agent or team

Assignment fires TicketAssigned, which triggers the TicketDispatcher to:

  1. Check if the agent is available
  2. Create a conversation channel for the agent + ticket
  3. Transition the ticket to in_progress
  4. Dispatch the agent

Add labels

Section titled “Add labels”

Labels help categorize and filter tickets:

  1. Open the ticket
  2. Click Add label
  3. Type a label name (e.g. “bug”, “feature”, “tech-debt”)

Labels are free-form strings. They’re stored on the ticket and displayed in the ticket list.

Section titled “Link tickets”

Create dependencies between tickets:

  1. Open a ticket
  2. Click Add link
  3. Select the target ticket
  4. Choose the link type:
TypeDescription
blocksThis ticket blocks the target
relatesToThe tickets are related
duplicateOfThis ticket is a duplicate

Add collaborators

Section titled “Add collaborators”

Invite agents or yourself to collaborate:

  1. Open the ticket
  2. Click Add collaborator
  3. Select an agent and assign a role (owner, contributor)
Section titled “Related guides”