--- agentTools: projectIndex: https://docs.wiboor.com.br/llms.txt projectSearch: https://docs.wiboor.com.br/agentSearch?query=term1%20term2 --- # Atualizar uma tarefa # OpenAPI definition ```json { "openapi": "3.0.0", "paths": { "/v1/tasks/{id}": { "put": { "operationId": "PublicTasksController_update", "parameters": [ { "name": "id", "required": true, "in": "path", "schema": { "type": "string" } } ], "requestBody": { "required": true, "description": "Dados para atualização da tarefa", "content": { "application/json": { "schema": { "title": "Body", "description": "Dados da tarefa", "$ref": "#/components/schemas/UpdateTaskPublicDto" } } } }, "responses": { "200": { "description": "Tarefa atualizada com sucesso", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TaskViewModel" } } } } }, "summary": "Atualizar uma tarefa", "tags": [ "Tarefas" ] } } }, "info": { "title": "Wiboor API", "description": "API da aplicação Wiboor, destinada a permitir a comunicação backend-to-backend entre sistemas. Ela possibilita o gerenciamento flexível de tarefas, projetos e equipes, oferecendo integração para outras aplicações de acordo com suas necessidades específicas.", "version": "1.0", "contact": {} }, "tags": [ { "name": "Tarefas", "description": "Tarefas e problemas: criação, execução com controle de tempo, comentários e checklist." } ], "servers": [ { "url": "https://api.azzimuti.com.br", "description": "Produção" } ], "components": { "securitySchemes": { "bearerAuth": { "type": "http", "scheme": "bearer", "description": "Token de API gerado no menu Token do seu perfil no Wiboor." } }, "schemas": { "TaskViewModel": { "type": "object", "properties": { "id": { "type": "string", "description": "ID único", "format": "uuid" }, "priority": { "type": "number", "description": "Prioridade da tarefa (1-10)", "minimum": 1, "maximum": 10 }, "status": { "type": "string", "description": "Status atual", "enum": [ "NOT_STARTED", "STARTED", "PAUSED", "FINISHED", "PENDING", "CANCELED", "REQUESTED" ] }, "createdAt": { "type": "string", "description": "Data de criação", "format": "date-time" }, "spentedTime": { "type": "integer", "description": "Tempo gasto executando a tarefa" }, "title": { "type": "string", "description": "Título da tarefa" }, "userRequesterId": { "type": "string", "description": "ID do usuário solicitante", "format": "uuid" }, "userRequester": { "description": "Informações do usuário solicitante", "allOf": [ { "$ref": "#/components/schemas/UserViewModel" } ] }, "userExecutorId": { "type": "string", "description": "ID do usuário executor", "format": "uuid" }, "userExecutor": { "description": "Informações do usuário executor", "allOf": [ { "$ref": "#/components/schemas/UserViewModel" } ] }, "description": { "type": "string", "description": "Descrição da tarefa", "nullable": true }, "endedAt": { "type": "string", "description": "Data de término planejada", "format": "date-time", "nullable": false }, "departmentId": { "type": "string", "description": "ID do departamento", "format": "uuid", "nullable": false }, "departmentGroupId": { "type": "string", "description": "ID do sub-espaço (grupo) ao qual a tarefa pertence", "format": "uuid", "nullable": true }, "finishedAt": { "type": "string", "description": "Se a tarefa foi finalizada, será listado a data de finalização", "format": "date-time", "nullable": true }, "pendencies": { "description": "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", "nullable": true, "type": "array", "items": { "$ref": "#/components/schemas/TaskPendencyViewModel" } }, "projectId": { "type": "string", "description": "ID do projeto", "format": "uuid", "nullable": true }, "startedAt": { "type": "string", "description": "Data de início planejada", "format": "date-time" }, "taskNumber": { "type": "number", "description": "Número da tarefa (único)" }, "type": { "type": "string", "description": "Tipo da tarefa (TASK | BUG)", "enum": [ "TASK", "BUG" ], "nullable": false }, "comments": { "description": "Comentários da tarefa, retornado apenas quando solicitado via join=comments", "type": "array", "items": { "$ref": "#/components/schemas/TaskCommentViewModel" } }, "checklist": { "description": "Itens do checklist da tarefa, retornado apenas quando solicitado via join=checklist", "type": "array", "items": { "$ref": "#/components/schemas/TaskChecklistItemViewModel" } }, "progress": { "type": "integer", "description": "Percentual agregado assistido (0-100) quando a tarefa é de curso; atualizado pela CEFIS", "minimum": 0, "maximum": 100, "nullable": true }, "courses": { "description": "Cursos da CEFIS vinculados à tarefa (vazio quando não é tarefa de curso)", "type": "array", "items": { "$ref": "#/components/schemas/TaskCourseViewModel" } } }, "required": [ "id", "priority", "status", "createdAt", "spentedTime", "title", "userRequesterId", "userRequester", "userExecutorId", "userExecutor", "endedAt", "departmentId", "startedAt", "taskNumber", "type", "courses" ] }, "TaskCourseViewModel": { "type": "object", "properties": { "id": { "type": "string", "description": "ID único do vínculo tarefa-curso", "format": "uuid" }, "courseId": { "type": "integer", "description": "ID do curso na CEFIS" }, "courseTitle": { "type": "string", "description": "Título do curso" }, "courseBanner": { "type": "string", "description": "URL do banner do curso", "nullable": true }, "workloadMinutes": { "type": "integer", "description": "Carga horária do curso em minutos", "nullable": true }, "percentWatched": { "type": "number", "description": "Percentual assistido do curso (0-100, com até 2 casas decimais)", "minimum": 0, "maximum": 100 }, "certificateEmittedAt": { "type": "string", "description": "Data de emissão do certificado do curso, quando emitido", "format": "date-time", "nullable": true } }, "required": [ "id", "courseId", "courseTitle", "percentWatched" ] }, "TaskChecklistItemViewModel": { "type": "object", "properties": { "id": { "type": "string", "description": "ID único do item do checklist", "format": "uuid" }, "description": { "type": "string", "description": "Descrição do item" }, "status": { "type": "string", "description": "Status do item", "enum": [ "UNCHECKED", "CHECKED" ] }, "parentId": { "type": "string", "description": "ID do grupo ao qual o item pertence; null se solto", "format": "uuid", "nullable": true }, "createdAt": { "type": "string", "description": "Data de criação", "format": "date-time" } }, "required": [ "id", "description", "status", "parentId", "createdAt" ] }, "TaskCommentViewModel": { "type": "object", "properties": { "id": { "type": "number", "description": "ID único do comentário" }, "message": { "type": "string", "description": "Texto do comentário" }, "userId": { "type": "string", "description": "ID do usuário autor do comentário", "format": "uuid" }, "isEdited": { "type": "boolean", "description": "Indica se o comentário foi editado" }, "createdAt": { "type": "string", "description": "Data de criação", "format": "date-time" } }, "required": [ "id", "message", "userId", "isEdited", "createdAt" ] }, "TaskPendencyViewModel": { "type": "object", "properties": { "id": { "type": "number", "description": "ID da pendência", "nullable": true }, "taskId": { "type": "string", "description": "ID da tarefa (se tiver pendencia de outra tarefa)", "format": "uuid" }, "ratingId": { "type": "string", "description": "ID da avaliação (se tiver pendencia de uma avaliação)", "format": "uuid", "nullable": true }, "processId": { "type": "string", "description": "ID do processo (se tiver pendencia com uma wiki)", "format": "uuid" }, "createdAt": { "type": "string", "description": "Data de criação da pendência", "format": "date-time" } }, "required": [ "id", "createdAt" ] }, "UserViewModel": { "type": "object", "properties": { "id": { "type": "string", "description": "ID único do usuário", "format": "uuid" }, "name": { "type": "string", "description": "Nome do usuário" }, "email": { "type": "string", "description": "Email do usuário", "format": "email" }, "createdAt": { "type": "string", "description": "Data de criação do usuário", "format": "date-time" } }, "required": [ "id", "name", "email", "createdAt" ] }, "UpdateTaskPublicDto": { "type": "object", "properties": { "userExecutorId": { "type": "string", "description": "ID do usuário executor da tarefa (UUID)", "format": "uuid" }, "projectId": { "type": "string", "description": "ID do projeto associado à tarefa (UUID). Só para `type` TASK: um BUG não pode fazer parte de um projeto (400).", "format": "uuid" }, "title": { "type": "string", "description": "Título da tarefa (string)", "maxLength": 191 }, "description": { "type": "string", "description": "Descrição detalhada da tarefa (string)", "maxLength": 20000 }, "startedAt": { "type": "string", "description": "Data e hora do planejamento para o início da tarefa (ISO 8601)", "format": "date-time" }, "endedAt": { "type": "string", "description": "Data e hora do planejamento para o término da tarefa (ISO 8601)", "format": "date-time" }, "priority": { "type": "number", "description": "Prioridade da tarefa (number, range: 1-10)", "minimum": 1, "maximum": 10 }, "departmentId": { "type": "string", "description": "ID do espaço responsável (UUID). Omitir mantém o espaço atual; enviar null é recusado, porque toda tarefa precisa de um espaço.", "format": "uuid" } }, "required": [ "userExecutorId", "title" ] } } }, "security": [ { "bearerAuth": [] } ] } ```