1

Custom-Statuses

Jonathan Miller edited this page 2026-06-27 00:36:22 +00:00

Contents

Table of Contents

• Custom Issue Statuses
• Default Statuses
• Required Baseline
• UI Features
• API

Custom Issue Statuses

Org-defined workflow states with auto close/reopen.

Default Statuses

Status	Color	Required
Open	green	Yes
In Progress	blue	No
Waiting	orange	No
In Review	purple	No
Closed	red	Yes
Won't Fix	gray	No

Required Baseline

Open and Closed are required statuses (is_required=true) and cannot be deleted. They serve as the baseline workflow states. Custom statuses can be freely added and deleted on top of these.

UI Features

• Status dropdown in comment form (replaces close/reopen button)
• Lock icon and disabled delete button for required statuses
• "Required" badge on required status rows
• Colored badges in issue list view

API

• GET /api/v1/orgs/{org}/issue_statuses -- list org statuses (includes is_required field)
• Issue create/update accepts status_id parameter
• The MCP server also supports the status_id field

Pages

• Branch-Protection-API
• Custom-Fields
• Custom-Statuses
• Home
• License-Management
• MCP-Server
• Metadata-API
• Metadata-Settings
• README
• Security-API
• Wiki-Folders
• api
  • Custom-Fields-API
  • org-branch-protection-api
  • project-api
• branding
• deployment
• features
  • Issue-Priorities
  • Issue-Types
  • Org-Governance
  • Well-Known-Tabs
  • cdn
• issue-management
• manifest-api
• manifest-settings
• operations
  • README
• roadmap
• security-scanning