Criar uma nova tarefa ou problema para alguém

POSThttps://api.azzimuti.com.br/v1/tasks

RECIPES

Parâmetros do body

obrigatórioapplication/json

Dados para criação da tarefa ou problema

userExecutorIdstringobrigatóriouuid
ID do usuário executor da tarefa (UUID)
projectIdstringuuid
ID do projeto associado à tarefa (UUID). Só para type TASK: um BUG não pode fazer parte de um projeto (400).
titlestringobrigatóriomáx. 191 caracteres
Título da tarefa (string)
descriptionstringmáx. 20000 caracteres
Descrição detalhada da tarefa (string)
startedAtstringdate-time
Data e hora do planejamento para o início da tarefa (ISO 8601)
endedAtstringdate-time
Data e hora do planejamento para o término da tarefa (ISO 8601)
prioritynumber≥ 1≤ 10
Prioridade da tarefa (number, range: 1-10)
Padrão: 1
typestringobrigatório
Tipo da tarefa (TASK | BUG)
Padrão: TASK
Valores permitidos:TASKBUG
departmentIdstringuuid
ID do espaço responsável (UUID)
departmentGroupIdstringuuid
ID do grupo de espaços ao qual a tarefa pertence (UUID)
checklistarray de objectsCreateTaskChecklistPublicDto
Itens de checklist a serem criados junto com a tarefa
checklist array de objects
Ver schema CreateTaskChecklistPublicDto
templateIdstringuuid
ID do template (UUID) usado para criar a tarefa. Precisa ser um template de tarefa (kind TASK) que você vê (membro ativo do espaço do template); senão, 404 "Template não encontrado". Fica registrado como origem da tarefa e só pode ser informado na criação. Obtenha-o em GET /v1/templates.

Respostas

201Created

Corpo da resposta

application/json

idstringobrigatóriouuid
ID único
prioritynumberobrigatório≥ 1≤ 10
Prioridade da tarefa (1-10)
statusstringobrigatório
Status atual
Valores permitidos:NOT_STARTEDSTARTEDPAUSEDFINISHEDPENDINGCANCELEDREQUESTED
createdAtstringobrigatóriodate-time
Data de criação
spentedTimeintegerobrigatório
Tempo gasto executando a tarefa
titlestringobrigatório
Título da tarefa
userRequesterIdstringobrigatóriouuid
ID do usuário solicitante
userRequesterobjectobrigatórioUserViewModel
Informações do usuário solicitante
userRequester object
Ver schema UserViewModel
userExecutorIdstringobrigatóriouuid
ID do usuário executor
userExecutorobjectobrigatórioUserViewModel
Informações do usuário executor
userExecutor object
Ver schema UserViewModel
descriptionstringpode ser nulo
Descrição da tarefa
endedAtstringobrigatóriodate-time
Data de término planejada
departmentIdstringobrigatóriouuid
ID do departamento
departmentGroupIdstringuuidpode ser nulo
ID do sub-espaço (grupo) ao qual a tarefa pertence
finishedAtstringdate-timepode ser nulo
Se a tarefa foi finalizada, será listado a data de finalização
pendenciesarray de objectspode ser nuloTaskPendencyViewModel
Se a tarefa tiver uma pendência, será listado o vinculo dessa pendência como por exemplo executar outra tarefa antes de executar essa tarefa
pendencies array de objects
Ver schema TaskPendencyViewModel
projectIdstringuuidpode ser nulo
ID do projeto
startedAtstringobrigatóriodate-time
Data de início planejada
taskNumbernumberobrigatório
Número da tarefa (único)
typestringobrigatório
Tipo da tarefa (TASK | BUG)
Valores permitidos:TASKBUG
commentsarray de objectsTaskCommentViewModel
Comentários da tarefa, retornado apenas quando solicitado via join=comments
comments array de objects
Ver schema TaskCommentViewModel
checklistarray de objectsTaskChecklistItemViewModel
Itens do checklist da tarefa, retornado apenas quando solicitado via join=checklist
checklist array de objects
Ver schema TaskChecklistItemViewModel
progressinteger≥ 0≤ 100pode ser nulo
Percentual agregado assistido (0-100) quando a tarefa é de curso; atualizado pela CEFIS
coursesarray de objectsobrigatórioTaskCourseViewModel
Cursos da CEFIS vinculados à tarefa (vazio quando não é tarefa de curso)
courses array de objects
Ver schema TaskCourseViewModel

Exemplo

{
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "priority": 1,
  "status": "NOT_STARTED",
  "createdAt": "2024-01-01T00:00:00Z",
  "spentedTime": 0,
  "title": "string",
  "userRequesterId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "userRequester": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "string",
    "email": "user@example.com",
    "createdAt": "2024-01-01T00:00:00Z"
  },
  "userExecutorId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "userExecutor": {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "name": "string",
    "email": "user@example.com",
    "createdAt": "2024-01-01T00:00:00Z"
  },
  "description": "string",
  "endedAt": "2024-01-01T00:00:00Z",
  "departmentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "departmentGroupId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "finishedAt": "2024-01-01T00:00:00Z",
  "pendencies": [
    {
      "id": 0,
      "taskId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "ratingId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "processId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "createdAt": "2024-01-01T00:00:00Z"
    }
  ],
  "projectId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "startedAt": "2024-01-01T00:00:00Z",
  "taskNumber": 0,
  "type": "TASK",
  "comments": [
    {
      "id": 0,
      "message": "string",
      "userId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "isEdited": true,
      "createdAt": "2024-01-01T00:00:00Z"
    }
  ],
  "checklist": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "description": "string",
      "status": "UNCHECKED",
      "parentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "createdAt": "2024-01-01T00:00:00Z"
    }
  ],
  "progress": 0,
  "courses": [
    {
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "courseId": 0,
      "courseTitle": "string",
      "courseBanner": "string",
      "workloadMinutes": 0,
      "percentWatched": 0,
      "certificateEmittedAt": "2024-01-01T00:00:00Z"
    }
  ]
}

RECIPES

Parâmetros do body

Respostas

Credenciais

Resposta