Task Types

REST API — All endpoints require authentication via Bearer token. Include Authorization: Bearer {token} in every request. Tokens are managed in GitScrum Settings → API. Base URL: https://services.gitscrum.com — All request paths in this documentation are relative to this base URL.

Task types categorize tasks within a project — such as Feature, Bug, Improvement, or any custom type you define. Each type has a color for visual identification on the board.

List Task Types

Returns available task types for a project.

GET /project-templates/type?company_slug={slug}&project_slug={slug}

Query Parameters

Example Request

curl -X GET "https://services.gitscrum.com/project-templates/type?company_slug=acme&project_slug=web-app" \
  -H "Authorization: Bearer {token}"

Example Response

{
  "data": [
    {
      "id": 1,
      "title": "Feature",
      "color": "4A90D9",
      "position": 1
    },
    {
      "id": 2,
      "title": "Bug",
      "color": "E74C3C",
      "position": 2
    },
    {
      "id": 3,
      "title": "Improvement",
      "color": "F39C12",
      "position": 3
    }
  ]
}

Create Task Type

Creates a new task type in the project.

POST /project-templates/type?company_slug={slug}&project_slug={slug}

Request Body

Example Request

curl -X POST "https://services.gitscrum.com/project-templates/type?company_slug=acme&project_slug=web-app" \
  -H "Authorization: Bearer {token}" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Chore",
    "color": "9B59B6"
  }'

Update Task Type

Updates an existing task type.

PUT /project-templates/type/{id}?company_slug={slug}&project_slug={slug}

Path Parameters

Request Body

List Effort Levels

Returns effort/priority levels configured for the project.

GET /project-templates/effort?company_slug={slug}&project_slug={slug}

Example Response

{
  "data": [
    {
      "id": 1,
      "title": "Low",
      "color": "27AE60",
      "position": 1
    },
    {
      "id": 2,
      "title": "Medium",
      "color": "F39C12",
      "position": 2
    },
    {
      "id": 3,
      "title": "High",
      "color": "E74C3C",
      "position": 3
    }
  ]
}

Field Reference