Method StartTaskRun

internal/api/core/tasks.go:1542–1583

StartTaskRun starts one claimed run.

(c *gin.Context)

// StartTaskRun starts one claimed run.
func (h *BaseHandlers) StartTaskRun(c *gin.Context) {
	manager, ok := h.requireTaskManager(c)
	if !ok {
		return
	}

	runID, err := requiredPathID(c.Param("id"), "run id")
	if err != nil {
		h.respondError(c, StatusForTaskError(err), err)
		return
	}

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

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

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

	run, err := manager.StartRun(c.Request.Context(), runID, startReq, actor)
	if err != nil {
		h.respondError(c, StatusForTaskError(err), err)
		return
	}

	c.JSON(http.StatusOK, contract.TaskRunResponse{Run: TaskRunPayloadFromRun(run)})
}

// AttachTaskRunSession binds one existing session to a run.
func (h *BaseHandlers) AttachTaskRunSession(c *gin.Context) {