Tipos de Tarefa

REST API — Todos os endpoints requerem autenticação via Bearer token. Inclua Authorization: Bearer {token} em cada requisição. Os tokens são gerenciados em Configurações do GitScrum → API. Base URL: https://services.gitscrum.com — Todos os caminhos de requisição nesta documentação são relativos a esta URL base.

Tipos de tarefa categorizam tarefas dentro de um projeto — como Feature, Bug, Melhoria ou qualquer tipo customizado que você definir. Cada tipo possui uma cor para identificação visual no quadro.

Listar Tipos de Tarefa

Retorna os tipos de tarefa disponíveis para um projeto.

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

Parâmetros de Query

Exemplo de Requisição

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

Exemplo de Resposta

{
  "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
    }
  ]
}

Criar Tipo de Tarefa

Cria um novo tipo de tarefa no projeto.

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

Corpo da Requisição

Exemplo de Requisição

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"
  }'

Atualizar Tipo de Tarefa

Atualiza um tipo de tarefa existente.

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

Parâmetros de Caminho

Corpo da Requisição

Listar Níveis de Esforço

Retorna os níveis de esforço/prioridade configurados para o projeto.

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

Exemplo de Resposta

{
  "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
    }
  ]
}

Referência de Campos