API docs, /stacks?filters=

[till]

Bug description

According to the API docs (on Swaggerhub), the parameter filters is a map[string]string, but that's not the case:

Error: Invalid query parameter: filters
Status Code 400
Details: json: cannot unmarshal string into Go struct field stackListOperationFilters.EndpointID of type int

See this line:

portainer/api/http/handler/stacks/stack_list.go

Lines 14 to 17 in b24891a

	type stackListOperationFilters struct {
	SwarmID string `json:"SwarmID"`
	EndpointID int `json:"EndpointID"`
	}

Should be updated that filters is of type stackListOperationFilters. And that should be included on SwaggerHub.

[deviantony]

Closing this issue as the documentation provides the correct way to pass the filters to the stackList operation.

The filters must be specified as JSON using your API client tool. Here is an example with httpie:

http GET :9000/api/stacks "Authorization: ${jwt}" filters:='{"EndpointID":1}'     
HTTP/1.1 200 OK
Content-Length: 3
Content-Type: application/json
Date: Thu, 31 Oct 2019 22:01:11 GMT
X-Content-Type-Options: nosniff
X-Xss-Protection: 1; mode=block

[]

An object is pretty much a map (or a dictionary) in JSON.