Method StartTask

internal/api/core/tasks.go:750–791

StartTask explicitly enqueues one executable run for an existing task.

(c *gin.Context)

// StartTask explicitly enqueues one executable run for an existing task.
func (h *BaseHandlers) StartTask(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
	}

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

	actor, err := h.taskActorContext(c, taskActionStart)
	if err != nil {
		h.respondError(c, StatusForTaskError(err), err)
		return
	}

	executionReq, err := taskExecutionRequestFromRequest(req)
	if err != nil {
		h.respondError(c, StatusForTaskError(err), err)
		return
	}

	execution, err := manager.StartTask(c.Request.Context(), taskID, executionReq, actor)
	if err != nil {
		h.respondError(c, StatusForTaskError(err), err)
		return
	}

	c.JSON(http.StatusCreated, TaskExecutionResponseFromExecution(execution))
}

// CancelTask requests cancellation for one task tree.
func (h *BaseHandlers) CancelTask(c *gin.Context) {