Spedy Docs

Ticket types classify what kind of work a ticket represents. Common types include Bug, Feature, and Epic. Each type has a name, color, and display order.

List Ticket Types

GET /api/v1/ticket-types

Returns all ticket types in the organization.

Example Response

{
  "data": [
    {
      "id": "typ_abc123",
      "name": "Feature",
      "color": "#3B82F6",
      "description": "New functionality",
      "order": 0,
      "isOrgDefault": true
    },
    {
      "id": "typ_def456",
      "name": "Bug",
      "color": "#EF4444",
      "description": "Something that needs fixing",
      "order": 1,
      "isOrgDefault": false
    }
  ]
}

Get Default Ticket Type

GET /api/v1/ticket-types/default

Returns the organization's default ticket type, used when no type is specified during ticket creation.

Create Ticket Type

POST /api/v1/ticket-types

Permission required: settings:manage-ticket-types

Request Body

Field	Type	Required	Description
name	string	Yes	Type name (max 50 characters)
color	string	Yes	Color in hex format (e.g. `#EF4444`)
description	string	No	Type description (max 500 characters)
order	number	No	Display order (0-100)
isOrgDefault	boolean	No	Set as the default type
enabledByDefault	boolean	No	Enabled by default on new boards

Example Request

{
  "name": "Epic",
  "color": "#8B5CF6",
  "description": "Large feature spanning multiple tickets"
}

Get Ticket Type

GET /api/v1/ticket-types/{typeId}

Returns a single ticket type.

Update Ticket Type

PATCH /api/v1/ticket-types/{typeId}

Permission required: settings:manage-ticket-types

Request Body

Field	Type	Required	Description
name	string	No	Type name
color	string	No	Color in hex format
description	string	No	Type description
order	number	No	Display order
isOrgDefault	boolean	No	Set as the default type

Delete Ticket Type

DELETE /api/v1/ticket-types/{typeId}

Permission required: settings:manage-ticket-types

Deletes a ticket type. You can optionally provide a replacement type for existing tickets.

Query Parameters

Parameter	Type	Required	Description
replacementTypeId	string	No	Reassign existing tickets to this type before deletion

Returns 204 No Content.

Ticket Types

List Ticket Types

Get Default Ticket Type

Create Ticket Type

Get Ticket Type

Update Ticket Type

Delete Ticket Type

On this page