portainer/portainer · error · ErrMissingQueryParameter

Missing query parameter

Error message

Missing query parameter

What it means

Error "Missing query parameter" thrown in portainer/portainer.

Source

Thrown at pkg/libhttp/request/request.go:123

	return routeVar, nil
}

// RetrieveNumericRouteVariableValue returns the value of a route variable as an integer.
func RetrieveNumericRouteVariableValue(request *http.Request, name string) (int, error) {
	routeVar, err := RetrieveRouteVariableValue(request, name)
	if err != nil {
		return 0, err
	}

	return strconv.Atoi(routeVar)
}

// RetrieveQueryParameter returns the value of a query parameter as a string.
// If optional is set to true, will not return an error when the query parameter is not found.
func RetrieveQueryParameter(request *http.Request, name string, optional bool) (string, error) {
	queryParameter := request.FormValue(name)
	if queryParameter == "" && !optional {
		return "", errors.New(ErrMissingQueryParameter)
	}

	return queryParameter, nil
}

// RetrieveNumericQueryParameter returns the value of a query parameter as an integer.
// If optional is set to true, will not return an error when the query parameter is not found.
func RetrieveNumericQueryParameter(request *http.Request, name string, optional bool) (int, error) {
	queryParameter, err := RetrieveQueryParameter(request, name, optional)
	if err != nil {
		return 0, err
	} else if queryParameter == "" && optional {
		return 0, nil
	}

	return strconv.Atoi(queryParameter)
}

View on GitHub (pinned to 17e74456ff)

When it happens

Trigger: Thrown at pkg/libhttp/request/request.go:123 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of portainer/portainer@17e74456ff (2026-08-26). Data as JSON: /api/errors/0ce3831624d9d5f4. Report an issue: GitHub.