Method EnqueueTaskRun

internal/api/core/tasks.go:1325–1366

EnqueueTaskRun creates one new queue-first run for the supplied task.

(c *gin.Context)

// EnqueueTaskRun creates one new queue-first run for the supplied task.
func (h *BaseHandlers) EnqueueTaskRun(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.EnqueueTaskRunRequest
	if err := decodeOptionalJSON(c, &req); err != nil {
		h.respondError(
			c,
			http.StatusBadRequest,
			NewTaskValidationError(fmt.Errorf("%s: decode enqueue run request: %w", h.transportName(), err)),
		)
		return
	}

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

	spec, err := enqueueTaskRunFromRequest(taskID, req)
	if err != nil {
		h.respondError(c, StatusForTaskError(err), err)
		return
	}

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

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

// FanOutTaskRuns creates designated sibling runs for one task.
func (h *BaseHandlers) FanOutTaskRuns(c *gin.Context) {