Method ClearTaskBlock

internal/api/core/tasks.go:380–419

ClearTaskBlock clears one open task block.

(c *gin.Context)

// ClearTaskBlock clears one open task block.
func (h *BaseHandlers) ClearTaskBlock(c *gin.Context) {
	manager, ok := h.requireTaskManager(c)
	if !ok {
		return
	}

	taskID, err := requiredPathID(c.Param("id"), "task id")
	if err != nil {
		h.respondError(c, StatusForTaskError(err), err)
		return
	}
	blockID, err := requiredPathID(c.Param("block_id"), "block id")
	if err != nil {
		h.respondError(c, StatusForTaskError(err), err)
		return
	}

	var req contract.ClearTaskBlockRequest
	if err := decodeOptionalJSON(c, &req); err != nil {
		h.respondError(
			c,
			http.StatusBadRequest,
			NewTaskValidationError(fmt.Errorf("%s: decode clear task block request: %w", h.transportName(), err)),
		)
		return
	}

	actor, err := h.taskActorContext(c, taskActionClearBlock)
	if err != nil {
		h.respondError(c, StatusForTaskError(err), err)
		return
	}
	block, err := manager.ClearTaskBlock(c.Request.Context(), taskID, blockID, strings.TrimSpace(req.Note), actor)
	if err != nil {
		h.respondError(c, statusForTaskBlockError(err), err)
		return
	}

	c.JSON(http.StatusOK, contract.TaskBlockResponse{Block: TaskBlockPayloadFromBlock(block)})
}

// RecoverTask clears task-level needs_attention state.
func (h *BaseHandlers) RecoverTask(c *gin.Context) {